commit dfa8716a1ccf1a49bf2b8f48873ccfaaf7a517fe
parent ea44b9cbca6ddf403ef42555b57b0d39b4a7d9e5
Author: Roberto E. Vargas Caballero <k0ga@shike2.net>
Date: Wed, 18 Mar 2026 16:11:20 +0100
doc: Get rid of useless sections in man pages
Diffstat:
8 files changed, 4 insertions(+), 85 deletions(-)
diff --git a/doc/man1/scc-addr2line.1 b/doc/man1/scc-addr2line.1
@@ -17,12 +17,10 @@ Addresses are specified in hexadecimal. For each address,
.B scc-addr2line
prints the corresponding source file name and line number to standard
output, in the form:
-.PP
-.in +4n
+.IP
.EX
filename:linenumber
.EE
-.in
.PP
If no addresses are given as arguments,
.B scc-addr2line
@@ -45,14 +43,6 @@ as the default executable.
.I addr
A hexadecimal address to translate. Multiple addresses may be specified
as separate arguments and will be translated in order.
-.SH EXIT STATUS
-.TP
-.B 0
-Successful completion.
-.TP
-.B >0
-An error occurred, such as an unrecognized file format, an invalid
-address, or no matching debug information found.
.SH EXAMPLES
Translate a single address in the default executable:
.IP
@@ -71,10 +61,6 @@ Read addresses from standard input:
.EX
echo 0x4005a0 | scc-addr2line \-e myprog
.EE
-.SH AUTHORS
-See the LICENSE file for the authors.
-.SH LICENSE
-See the LICENSE file for the terms of redistribution.
.SH SEE ALSO
.BR scc-nm (1),
.BR scc-objdump (1),
diff --git a/doc/man1/scc-ar.1 b/doc/man1/scc-ar.1
@@ -215,13 +215,6 @@ The pathname of the archive file to be created, modified, or examined.
A pathname of a file to be added to, extracted from, or listed in the archive.
When adding files to an archive, the canonical name (basename) of the file
is stored in the archive, stripped of any directory components.
-.SH EXIT STATUS
-.TP
-.B 0
-Successful completion.
-.TP
-.B >0
-An error occurred.
.SH IMPLEMENTATION NOTES
The
.B scc-ar
@@ -325,28 +318,20 @@ If the
modifier is not specified and a new archive is created,
.B scc-ar
writes the following message to standard error:
-.PP
-.in +4n
+.IP
.EX
ar: creating archive
.EE
-.in
.PP
Error messages are written to standard error and have the format:
-.PP
-.in +4n
+.IP
.EX
ar: archive: message
.EE
-.in
.SH STANDARDS
The
.B scc-ar
utility is designed to conform to IEEE Std 1003.1-2008 (POSIX.1).
-.SH AUTHORS
-See the LICENSE file for the authors.
-.SH LICENSE
-See the LICENSE file for the terms of redistribution.
.SH SEE ALSO
.BR scc-ranlib (1),
.BR scc-ld (1),
@@ -358,3 +343,4 @@ The
utility does not create a symbol table by default. Use
.BR scc-ranlib (1)
to add a symbol table to an archive.
+The option \-s is not implemented.
diff --git a/doc/man1/scc-cc.1 b/doc/man1/scc-cc.1
@@ -159,12 +159,6 @@ defines the format of the output executable.
.TP
.B SCCPREFIX
defines the path prefix scc will search the scc suite in.
-.SH AUTHORS
-See the LICENSE file for the authors.
-.SH LICENSE
-See the LICENSE file for the terms of redistribution.
.SH SEE ALSO
.BR scc-cpp (1),
.BR scc-make (1)
-.SH BUGS
-See the TODO file in the distribution.
diff --git a/doc/man1/scc-nm.1 b/doc/man1/scc-nm.1
@@ -158,13 +158,6 @@ If no operands are given,
.B scc-nm
reads from
.BR a.out .
-.SH EXIT STATUS
-.TP
-.B 0
-Successful completion.
-.TP
-.B >0
-An error occurred.
.SH EXAMPLES
List symbols from an object file:
.IP
@@ -211,8 +204,6 @@ scc-nm \-A foo.o bar.o
The
.B scc-nm
utility is designed to conform to IEEE Std 1003.1-2008 (POSIX.1).
-.SH LICENSE
-See the LICENSE file for the terms of redistribution.
.SH SEE ALSO
.BR scc-ar (1),
.BR scc-ranlib (1),
diff --git a/doc/man1/scc-objdump.1 b/doc/man1/scc-objdump.1
@@ -158,13 +158,6 @@ If no operands are given,
.B scc-objdump
reads from
.BR a.out .
-.SH EXIT STATUS
-.TP
-.B 0
-Successful completion.
-.TP
-.B >0
-An error occurred.
.SH EXAMPLES
Display file header information for an object file:
.IP
@@ -213,8 +206,6 @@ Display all available information:
.EX
scc-objdump \-afhst foo.o
.EE
-.SH LICENSE
-See the LICENSE file for the terms of redistribution.
.SH SEE ALSO
.BR scc-nm (1),
.BR scc-size (1),
diff --git a/doc/man1/scc-ranlib.1 b/doc/man1/scc-ranlib.1
@@ -32,13 +32,6 @@ but has no effect.
.I archive
The pathname of an archive file to be indexed.
One or more archive files must be specified.
-.SH EXIT STATUS
-.TP
-.B 0
-Successful completion.
-.TP
-.B >0
-An error occurred processing one or more archives.
.SH EXAMPLES
Generate a symbol index for a library archive:
.IP
@@ -63,10 +56,6 @@ If a member within the archive caused the error, the format is:
.EX
scc-ranlib: archive: member: message
.EE
-.SH AUTHORS
-See the LICENSE file for the authors.
-.SH LICENSE
-See the LICENSE file for the terms of redistribution.
.SH SEE ALSO
.BR scc-ar (1),
.BR scc-ld (1),
diff --git a/doc/man1/scc-size.1 b/doc/man1/scc-size.1
@@ -94,13 +94,6 @@ If no operands are given,
.B scc-size
reads from
.BR a.out .
-.SH EXIT STATUS
-.TP
-.B 0
-Successful completion.
-.TP
-.B >0
-An error occurred.
.SH EXAMPLES
Display the section sizes of an object file:
.IP
@@ -123,8 +116,6 @@ scc-size \-t foo.o bar.o baz.o
The
.B scc-size
utility is designed to conform to IEEE Std 1003.1-2008 (POSIX.1).
-.SH LICENSE
-See the LICENSE file for the terms of redistribution.
.SH SEE ALSO
.BR scc-ar (1),
.BR scc-nm (1),
diff --git a/doc/man1/scc-strip.1 b/doc/man1/scc-strip.1
@@ -35,13 +35,6 @@ If no operands are given,
.B strip
operates on
.BR a.out .
-.SH EXIT STATUS
-.TP
-.B 0
-Successful completion.
-.TP
-.B >0
-An error occurred processing one or more files.
.SH EXAMPLES
Strip the default output file:
.IP
@@ -64,8 +57,6 @@ scc-strip foo.o bar.o baz.o
The
.B scc-strip
utility is designed to conform to IEEE Std 1003.1-2008 (POSIX.1).
-.SH LICENSE
-See the LICENSE file for the terms of redistribution.
.SH SEE ALSO
.BR scc-ar (1),
.BR scc-nm (1),
