Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

nixos/docs: fix typo #372394

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Conversation

antonmosich
Copy link
Contributor

If that string wasn't a raw string, the "\n" in the second line won't get rendered as such, but as a space instead.

Things done

  • Built on platform(s)
    • x86_64-linux
    • aarch64-linux
    • x86_64-darwin
    • aarch64-darwin
  • For non-Linux: Is sandboxing enabled in nix.conf? (See Nix manual)
    • sandbox = relaxed
    • sandbox = true
  • Tested, as applicable:
  • Tested compilation of all packages that depend on this change using nix-shell -p nixpkgs-review --run "nixpkgs-review rev HEAD". Note: all changes have to be committed, also see nixpkgs-review usage
  • Tested basic functionality of all binary files (usually in ./result/bin/)
  • 25.05 Release Notes (or backporting 24.11 and 25.05 Release notes)
    • (Package updates) Added a release notes entry if the change is major or breaking
    • (Module updates) Added a release notes entry if the change is significant
    • (Module addition) Added a release notes entry if adding a new NixOS module
  • Fits CONTRIBUTING.md.

Add a 👍 reaction to pull requests you find important.

If that string wasn't a raw string, the "\n" in the second line won't
get rendered as such, but as a space instead.
@github-actions github-actions bot added 6.topic: nixos Issues or PRs affecting NixOS modules, or package usability issues specific to NixOS 6.topic: testing Tooling for automated testing of packages and modules labels Jan 9, 2025
@nix-owners nix-owners bot requested a review from tfc January 9, 2025 14:47
Copy link
Member

@qxrein qxrein left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this won't affect anything in the docs

@@ -726,7 +726,7 @@ def tty_matches(last: bool) -> bool:
retry(tty_matches, timeout)

def send_chars(self, chars: str, delay: float | None = 0.01) -> None:
"""
r"""
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

why do you think raw string docstring is needed here?
tbh there's no need for this because docstring was already displaying \n correctly because it was inside backticks which preserve literal characters.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Backticks might preserve literal characters in the language the docs are written in, but they don't in python code. Diffing the docs before and after my commit show that this change does affect the docs.

$ diff before/share/doc/nixos/index.html after/share/doc/nixos/index.html
9c9
< <script src="./highlightjs/highlight.pack.js" type="text/javascript"></script><script src="./highlightjs/loader.js" type="text/javascript"></script><script src="./anchor.min.js" type="text/javascript"></script><script src="./anchor-use.js" type="text/javascript"></script><script src="/nix/store/jbb6003fi70xmszwrfk3r70sdjcmaji5-nixos-manual-html/share/doc/nixos/index-redirects.js" type="text/javascript"></script>
---
> <script src="./highlightjs/highlight.pack.js" type="text/javascript"></script><script src="./highlightjs/loader.js" type="text/javascript"></script><script src="./anchor.min.js" type="text/javascript"></script><script src="./anchor-use.js" type="text/javascript"></script><script src="/nix/store/dg0pkw0y31cdhjyz7xd4ii719zh450pj-nixos-manual-html/share/doc/nixos/index-redirects.js" type="text/javascript"></script>
9203c9203
< e.g., <code class="literal">send_chars(&quot;foobar   &quot;)</code> will type the string <code class="literal">foobar</code>
---
> e.g., <code class="literal">send_chars(&quot;foobar\n&quot;)</code> will type the string <code class="literal">foobar</code>

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ok that makes sense

Copy link
Member

@qxrein qxrein left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm

@@ -726,7 +726,7 @@ def tty_matches(last: bool) -> bool:
retry(tty_matches, timeout)

def send_chars(self, chars: str, delay: float | None = 0.01) -> None:
"""
r"""
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ok that makes sense

@wegank wegank added the 12.approvals: 1 This PR was reviewed and approved by one reputable person label Jan 9, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
6.topic: nixos Issues or PRs affecting NixOS modules, or package usability issues specific to NixOS 6.topic: testing Tooling for automated testing of packages and modules 10.rebuild-darwin: 1-10 10.rebuild-linux: 1-10 12.approvals: 1 This PR was reviewed and approved by one reputable person
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants