Michael Jarvis
496d7c44a1
Fix sphinx doc warning
...
~/src/fish-shell/doc_src/cmds/argparse.rst:103: WARNING: Literal block ends without a blank line; unexpected unindent.
~/src/fish-shell/doc_src/cmds/argparse.rst:103: WARNING: Literal block ends without a blank line; unexpected unindent.
2021-02-05 11:07:58 +01:00
Fabian Homborg
3eef295990
docs/argparse: Remove more of the vestigial shortopt mentions
...
It should only be mentioned as a backwards-compatibility measure,
because it is useless - not even the short flag variable is set.
2021-02-03 19:13:53 +01:00
Fabian Homborg
8bb3d1198f
docs: Make code lines shorter
2021-02-02 08:29:31 +01:00
Fabian Homborg
b43a8688fe
docs: Correct argparse on short- options
...
These aren't exposed as variables at all, so it's just entirely
vestigial now and only kept for backwards compatibility.
2021-01-01 14:22:22 +01:00
Fabian Homborg
57d23c390b
docs: Reword argparse a bit
...
In particular use "variable" instead of "var".
2021-01-01 14:03:00 +01:00
Fabian Homborg
7ea8e20623
argparse: Make short flag names optional ( #7585 )
...
It was always a bit ridiculous that argparse required `X-longflag` if
that "X" short flag was never actually used anywhere.
Since the short letter is for getopt's benefit, we can hack around
this with our old friend: Unicode Private Use Areas.
We have a counter, starting at 0xE000 and going to 0xF8FF, that counts
up for all options that don't have a short flag and provides one. This
gives us up to 6400 long-only options.
6.4K should be enough for everybody.
2021-01-01 11:37:25 +01:00
Marcus Atilius Regulus
7b9c1a6076
escape a backslash (in 2 places) in argparse docs
2020-11-13 14:27:12 +01:00
Johannes Altmanninger
4081d58577
docs: use monospace for inline code snippets more consistently
2020-10-26 19:25:41 +01:00
Charles Gould
f73ee30111
docs: Fix markup for code blocks
2020-10-10 21:49:33 +02:00
Fabian Homborg
0eeaa796fd
docs: Fix argparse chapter
...
Missing a label.
Oops.
[ci skip]
2020-10-08 17:35:29 +02:00
Fabian Homborg
392b61014b
docs: Some more argparse rewordings
...
[ci skip]
2020-10-07 21:52:35 +02:00
Fabian Homborg
547f649797
docs: Slight reword of argparse's optional argument section
...
[ci skip]
2020-06-17 15:36:50 +02:00
Fabian Homborg
5efe1a09ce
docs/argparse: Add note on optional arguments
...
Yeah I had to answer this one again.
[ci skip]
2020-06-04 17:28:02 +02:00
fcd
3246f736b8
docs: Fix repeated word in argparse documentation
2020-03-25 18:23:19 +01:00
Fabian Homborg
bfc1de9ef4
argparse: Pass validation variables as exported
...
This was written before local-exported variables did anything useful.
Passing these vars as local-exports removes the need to define the
validation function with `--no-scope-shadowing` which is quite the
hack.
2020-03-01 19:28:51 +01:00
Aaron Gyes
85a0ca66e0
We no longer have two doc systems, move sphinx_doc_src back to doc_src
2020-02-19 17:00:35 -08:00
