Skip to content

[Docs] help2man man-page generation is missing a [DESCRIPTION] section #100

@nktnet1

Description

@nktnet1

In lib/help2man_include.txt, there is no [DESCRIPTION] section.

Here is what it used to look like on CSE machines (v2.7.8, running man dcc):

DESCRIPTION
       -fsanitize=<sanitizer1,sanitizer2>
              run two sanitizers (default -fsanitize=address,valgrind) The second sanitizer is a separate process.  The synchroni‐
              sation of the 2 processes should be effective for most use of the standard C  library  and  hence  should  work  for
              novice programmers.  If synchronisation is lost the 2nd sanitizer terminates silently.

       -fsanitize=<sanitizer>
              check  for  runtime  errors using using a single sanitizer which can be one of address       - AddressSanitizer, in‐
              valid memory operations valgrind      - valgrind, primarily uninitialized variables memory        - MemorySanitizer,
              primarily uninitialized variables

       --leak-check
              check for memory leaks, requires --fsanitizer=valgrind to intercept errors

       --no-explanations
              do not add explanations to compile-time error messages

       --no-shared-libasan
              do not use libasan

       --ifdef
              use ifdef instead of ld's -wrap option

Since help2man relies on dcc's --version and --help options:

dcc/Makefile

Lines 23 to 24 in f41dca3

dcc.1: dcc lib/help2man_include.txt
help2man --include=lib/help2man_include.txt ./dcc >dcc.1

but the --help option is outputting nothing:

elif arg == "--help":
print()
sys.exit(0)

we end up with a man page that looks like this:

DCC(1)                                                      User Commands                                                      DCC(1)

NAME
       dcc - manual page for dcc version 2.34

DESCRIPTION
ENVIRONMENT
       DCC_DEBUG level of debugging output

EXAMPLES
           $ dcc buffer_overflow.c
           $ ./a.out
           a.c:6:3: runtime error: index 10 out of bounds for type 'int [10]'
           
          ... truncated ...

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions