lint: let clap_help_markdown allow code spans in help text

Add `ignore_constructs = ["code_span"]` and restore the backticks in the
two `--omit-json-shared-*` doc comments, then regenerate the completions,
help text, `USAGE.md`, and man page.

https://claude.ai/code/session_016ZyYFnzSv876usUHLEX4qe

Author: claude

USAGE.md

@@ -125,12 +125,12 @@ Set the maximum number of threads to spawn. Could be either "auto", "max", or a
 <a id="omit-json-shared-details" name="omit-json-shared-details"></a>
 ### `--omit-json-shared-details`
 
-Do not output .shared.details in the JSON output.
+Do not output `.shared.details` in the JSON output.
 
 <a id="omit-json-shared-summary" name="omit-json-shared-summary"></a>
 ### `--omit-json-shared-summary`
 
-Do not output .shared.summary in the JSON output.
+Do not output `.shared.summary` in the JSON output.
 
 <a id="option-h" name="option-h"></a><a id="help" name="help"></a>
 ### `--help`

dylint.toml

@@ -34,3 +34,6 @@ allow_extra = ["assert_op_expr"]
 
 ["perfectionist::single_letter_closure_param"]
 extra_trivial_callback_methods = ["sort_reflection_by"]
+
+["perfectionist::clap_help_markdown"]
+ignore_constructs = ["code_span"]

exports/completion.elv

@@ -48,8 +48,8 @@ set edit:completion:arg-completer[pdu] = {|@words|
             cand --no-errors 'Prevent filesystem error messages from appearing in stderr'
             cand -p 'Report progress being made at the expense of performance'
             cand --progress 'Report progress being made at the expense of performance'
-            cand --omit-json-shared-details 'Do not output .shared.details in the JSON output'
-            cand --omit-json-shared-summary 'Do not output .shared.summary in the JSON output'
+            cand --omit-json-shared-details 'Do not output `.shared.details` in the JSON output'
+            cand --omit-json-shared-summary 'Do not output `.shared.summary` in the JSON output'
             cand -h 'Print help (see more with ''--help'')'
             cand --help 'Print help (see more with ''--help'')'
             cand -V 'Print version'

exports/completion.fish

@@ -18,7 +18,7 @@ complete -c pdu -l align-right -d 'Set the root of the bars to the right'
 complete -c pdu -l no-sort -d 'Do not sort the branches in the tree'
 complete -c pdu -s s -l silent-errors -l no-errors -d 'Prevent filesystem error messages from appearing in stderr'
 complete -c pdu -s p -l progress -d 'Report progress being made at the expense of performance'
-complete -c pdu -l omit-json-shared-details -d 'Do not output .shared.details in the JSON output'
-complete -c pdu -l omit-json-shared-summary -d 'Do not output .shared.summary in the JSON output'
+complete -c pdu -l omit-json-shared-details -d 'Do not output `.shared.details` in the JSON output'
+complete -c pdu -l omit-json-shared-summary -d 'Do not output `.shared.summary` in the JSON output'
 complete -c pdu -s h -l help -d 'Print help (see more with \'--help\')'
 complete -c pdu -s V -l version -d 'Print version'

exports/completion.ps1

@@ -51,8 +51,8 @@ Register-ArgumentCompleter -Native -CommandName 'pdu' -ScriptBlock {
             [CompletionResult]::new('--no-errors', '--no-errors', [CompletionResultType]::ParameterName, 'Prevent filesystem error messages from appearing in stderr')
             [CompletionResult]::new('-p', '-p', [CompletionResultType]::ParameterName, 'Report progress being made at the expense of performance')
             [CompletionResult]::new('--progress', '--progress', [CompletionResultType]::ParameterName, 'Report progress being made at the expense of performance')
-            [CompletionResult]::new('--omit-json-shared-details', '--omit-json-shared-details', [CompletionResultType]::ParameterName, 'Do not output .shared.details in the JSON output')
-            [CompletionResult]::new('--omit-json-shared-summary', '--omit-json-shared-summary', [CompletionResultType]::ParameterName, 'Do not output .shared.summary in the JSON output')
+            [CompletionResult]::new('--omit-json-shared-details', '--omit-json-shared-details', [CompletionResultType]::ParameterName, 'Do not output `.shared.details` in the JSON output')
+            [CompletionResult]::new('--omit-json-shared-summary', '--omit-json-shared-summary', [CompletionResultType]::ParameterName, 'Do not output `.shared.summary` in the JSON output')
             [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
             [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help (see more with ''--help'')')
             [CompletionResult]::new('-V', '-V ', [CompletionResultType]::ParameterName, 'Print version')

exports/completion.zsh

@@ -53,8 +53,8 @@ block-count\:"Count numbers of blocks"))' \
 '--no-errors[Prevent filesystem error messages from appearing in stderr]' \
 '-p[Report progress being made at the expense of performance]' \
 '--progress[Report progress being made at the expense of performance]' \
-'--omit-json-shared-details[Do not output .shared.details in the JSON output]' \
-'--omit-json-shared-summary[Do not output .shared.summary in the JSON output]' \
+'--omit-json-shared-details[Do not output \`.shared.details\` in the JSON output]' \
+'--omit-json-shared-summary[Do not output \`.shared.summary\` in the JSON output]' \
 '-h[Print help (see more with '\''--help'\'')]' \
 '--help[Print help (see more with '\''--help'\'')]' \
 '-V[Print version]' \

exports/long.help

@@ -86,10 +86,10 @@ Options:
           [default: auto]
 
       --omit-json-shared-details
-          Do not output .shared.details in the JSON output
+          Do not output `.shared.details` in the JSON output
 
       --omit-json-shared-summary
-          Do not output .shared.summary in the JSON output
+          Do not output `.shared.summary` in the JSON output
 
   -h, --help
           Print help (see a summary with '-h')

exports/pdu.1

@@ -109,10 +109,10 @@ Report progress being made at the expense of performance
 Set the maximum number of threads to spawn. Could be either "auto", "max", or a positive integer
 .TP
 \fB\-\-omit\-json\-shared\-details\fR
-Do not output .shared.details in the JSON output
+Do not output `.shared.details` in the JSON output
 .TP
 \fB\-\-omit\-json\-shared\-summary\fR
-Do not output .shared.summary in the JSON output
+Do not output `.shared.summary` in the JSON output
 .TP
 \fB\-h\fR, \fB\-\-help\fR
 Print help (see a summary with '\-h')

exports/short.help

@@ -39,9 +39,9 @@ Options:
       --threads <THREADS>
           Set the maximum number of threads to spawn. Could be either "auto", "max", or a positive integer [default: auto]
       --omit-json-shared-details
-          Do not output .shared.details in the JSON output
+          Do not output `.shared.details` in the JSON output
       --omit-json-shared-summary
-          Do not output .shared.summary in the JSON output
+          Do not output `.shared.summary` in the JSON output
   -h, --help
           Print help (see more with '--help')
   -V, --version

src/args.rs

@@ -168,11 +168,11 @@ pub struct Args {
     #[clap(long, default_value_t = Threads::Auto)]
     pub threads: Threads,
 
-    /// Do not output .shared.details in the JSON output.
+    /// Do not output `.shared.details` in the JSON output.
     #[clap(long, requires = "json_output", requires = "deduplicate_hardlinks")]
     pub omit_json_shared_details: bool,
 
-    /// Do not output .shared.summary in the JSON output.
+    /// Do not output `.shared.summary` in the JSON output.
     #[clap(long, requires = "json_output", requires = "deduplicate_hardlinks")]
     pub omit_json_shared_summary: bool,
 }