1
0
mirror of git://git.suckless.org/sbase synced 2025-01-02 21:12:15 +00:00
sbase/strings.1
Brandon Pribula d458fa2c7b fix: update man pages to standard mdoc date format
When viewing sbase's man pages the date displayed at the bottom is
the current date rather than the date entered in the <program>.1
file.

According to this:

https://mandoc.bsd.lv/mdoc/details/date.html

The traditional man date format used by sbase (.Dd year-month-day)
is no longer recommended and no longer supported by GNU troff or
Heirloom Docs and as a result the current date is displayed instead.
Although this format is still accepted by mandoc for backward
compatibility.

For portability it states the standard mdoc date format should be
used instead: .Dd month day, year

I applied the following patch to sbase's last commit b30fb56 and
it fixes the issue.
2024-09-08 08:35:39 +02:00

55 lines
864 B
Groff

.Dd October 8, 2015
.Dt STRINGS 1
.Os sbase
.Sh NAME
.Nm strings
.Nd print strings of printable characters in files
.Sh SYNOPSIS
.Nm
.Op Fl a
.Op Fl n Ar num
.Op Fl t Ar format
.Op Ar file ...
.Sh DESCRIPTION
.Nm
writes sequences of at least 4 printable characters in each
.Ar file
to stdout.
If no
.Ar file
is given,
.Nm
reads from stdin.
.Sh OPTIONS
.Bl -tag -width Ds
.It Fl a
Scan each
.Ar file
entirely.
This is the default.
.It Fl n Ar num
Print sequences of at least
.Ar num
characters.
The default is 4.
.It Fl t Ar format
Prepend each string with its byte offset, with
.Ar format
being one of
.Sy d , o , x
for decimal, octal or hexadecimal numbers.
.El
.Sh STANDARDS
The
.Nm
utility is compliant with the
.St -p1003.1-2013
specification.
.Pp
The
.Op Fl t
output format has been changed from "%F %s" to "%8lF: %s", with
.Sy F
being one of
.Sy d , o , x .