-
-
Notifications
You must be signed in to change notification settings - Fork 14.7k
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
base: master
Are you sure you want to change the base?
nixos/docs: fix typo #372394
Conversation
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.
There was a problem hiding this 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""" |
There was a problem hiding this comment.
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.
There was a problem hiding this comment.
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("foobar ")</code> will type the string <code class="literal">foobar</code>
---
> e.g., <code class="literal">send_chars("foobar\n")</code> will type the string <code class="literal">foobar</code>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
ok that makes sense
There was a problem hiding this 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""" |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
ok that makes sense
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
nix.conf
? (See Nix manual)sandbox = relaxed
sandbox = true
nix-shell -p nixpkgs-review --run "nixpkgs-review rev HEAD"
. Note: all changes have to be committed, also see nixpkgs-review usage./result/bin/
)Add a 👍 reaction to pull requests you find important.