opensource/podman
1
0
Fork 0
mirror of https://github.com/containers/podman.git synced 2025-10-17 19:24:04 +08:00
Code Issues Packages Projects Releases Wiki Activity

Revert escaped double dash man page flag syntax

Browse Source 
Commit 800a2e2d35 introduced a way to disable the conversion of `--`into
an en dash on docs.podman.io, so the ugly workaround of escaping the
dashes is no longer necessary.

Signed-off-by: Paul Holzinger <paul.holzinger@web.de>
This commit is contained in:
Paul Holzinger
2021-05-07 18:30:00 +02:00
parent 5616887f62
commit 30e731ecc8
114 changed files with 977 additions and 988 deletions
Download Patch File Download Diff File Expand all files Collapse all files

17
hack/xref-helpmsgs-manpages
View File

@ -331,23 +331,12 @@ sub podman_man {
@most_recent_flags = ();
# As of PR #8292, all options are <h4> and anchored
if ($line =~ s/^\#{4}\s+//) {
# 2021-03: PR #9856: some (bleep) markdown processor converts
# double dashes to a single em-dash. We need to escape every
# instance with backslashes. This is anti-intuitive, and
# developers will naturally write --foo; try to catch that
# and warn with a helpful message.
if ($line =~ /--([a-z]+)/) {
warn "$ME: $subpath:$.: You probably need to backslash-escape '--$1' as '\\-\\-$1'\n";
}
# If option has long and short form, long must come first.
# This is a while-loop because there may be multiple long
# option names, e.g. --net/--network
while ($line =~ s/^\*\*\\-\\-([a-z0-9-]+)\*\*(=\*[a-zA-Z0-9-]+\*)?(,\s+)?//g) {
# add -- to the flag name
my $flag = "--".$1;
$man{$flag} = 1;
push @most_recent_flags, $flag;
while ($line =~ s/^\*\*(--[a-z0-9-]+)\*\*(=\*[a-zA-Z0-9-]+\*)?(,\s+)?//g) {
$man{$1} = 1;
push @most_recent_flags, $1;
}
# Short form
if ($line =~ s/^\*\*(-[a-zA-Z0-9])\*\*(=\*[a-zA-Z0-9-]+\*)?//g) {