CVS log for mandoc/catman.8

[BACK] Up to [cvsweb.bsd.lv] / mandoc

Request diff between arbitrary revisions


Default branch: MAIN


Revision 1.14 / (download) - annotate - [select for diffs], Mon Jun 30 12:28:12 2025 UTC (9 days, 21 hours ago) by schwarze
Branch: MAIN
CVS Tags: HEAD
Changes since 1.13: +9 -2 lines
Diff to previous 1.13 (colored) to selected 1.7 (colored)

Document the message reporting recv(2) failure, and
describe the one reporting fts_open(3) failure a bit better.

Revision 1.13 / (download) - annotate - [select for diffs], Mon Jun 30 11:24:30 2025 UTC (9 days, 22 hours ago) by schwarze
Branch: MAIN
Changes since 1.12: +46 -6 lines
Diff to previous 1.12 (colored) to selected 1.7 (colored)

Reuse the existing socket pair as a backchannel from mandocd(8) to catman(8).

This is needed because catman(8) can pass messages to mandocd(8) much
faster than mandocd(8) can process them: to file a new message, catman(8)
does not need to do much more than one call to fts_read(3), wheres
mandocd(8) needs to read, parse, and format the whole file in response.
So unprocessed messages pile up in the kernel, each of them containing
three file descriptors in flight, ultimately resulting in catman(8)
dying with:

catman: FATAL: sendmsg: Too many open files

The catman(8) program cannot find out on its own how far mandocd(8)
has progressed, so mandocd(8) has to tell it.

Each time mandocd(8) accepts a message from catman(8), it now sends
a one-byte message back.  When catman(8) has the number of files in
flight that it considers acceptable, it does a blocking recv(3),
such that no more files get sent until at least one has been
accepted.  As soon as it gets one message back, catman(8) then
does further non-blocking recv(3)s until they no longer succeed,
to reduce the count of files in flight as much as possible
before returning to sending more files.

When processing is complete or aborted, catman(8) waits for the
remaining files to be accepted before exiting.

Debugging output related to this feature is available with -vv.

Revision 1.12 / (download) - annotate - [select for diffs], Mon Jun 30 01:44:28 2025 UTC (10 days, 7 hours ago) by schwarze
Branch: MAIN
Changes since 1.11: +19 -1 lines
Diff to previous 1.11 (colored) to selected 1.7 (colored)

Signal handling for catman(8).
This is useful for doing a clean shutdown, including printing the summary
messages at the end, when we get SIGHUP, SIGINT, SIGPIPE, or SIGTERM.
Besides, when we catch SIGCHLD, we no longer need to try sendmsg(3),
which avoids SIGPIPE in some cases.  Since the child may die between
the time we check whether we got a signal and time we issue the next
sendmsg(3), it does not always prevent SIGPIPE, so SIGPIPE handling
is still necessary.

Revision 1.11 / (download) - annotate - [select for diffs], Sun Jun 29 23:51:40 2025 UTC (10 days, 9 hours ago) by schwarze
Branch: MAIN
Changes since 1.10: +20 -2 lines
Diff to previous 1.10 (colored) to selected 1.7 (colored)

implement and document verbose mode

Revision 1.10 / (download) - annotate - [select for diffs], Sun Jun 29 23:21:07 2025 UTC (10 days, 10 hours ago) by schwarze
Branch: MAIN
Changes since 1.9: +17 -3 lines
Diff to previous 1.9 (colored) to selected 1.7 (colored)

more detailed error reporting about wrong numbers of arguments

Revision 1.9 / (download) - annotate - [select for diffs], Sun Jun 29 23:00:58 2025 UTC (10 days, 10 hours ago) by schwarze
Branch: MAIN
Changes since 1.8: +111 -25 lines
Diff to previous 1.8 (colored) to selected 1.7 (colored)

document DIAGNOSTICS in more detail

Revision 1.8 / (download) - annotate - [select for diffs], Sat Mar 18 19:56:01 2017 UTC (8 years, 3 months ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_14_6, VERSION_1_14_5, VERSION_1_14_4, VERSION_1_14_3, VERSION_1_14_2
Changes since 1.7: +3 -3 lines
Diff to previous 1.7 (colored)

minor issues found with mandoc -Tlint

Revision 1.7 / (download) - annotate - [selected], Mon Feb 6 19:04:21 2017 UTC (8 years, 5 months ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_14_1
Changes since 1.6: +153 -78 lines
Diff to previous 1.6 (colored)

new manual pages for catman(8) and mandocd(8)

Revision 1.5.2.1, Tue Aug 5 00:42:53 2014 UTC (10 years, 11 months ago) by schwarze
Branch: VERSION_1_12
Changes since 1.5: +2 -2 lines
FILE REMOVED

Remove the old man.cgi.
Running that would not be a responsible thing to do, nowadays.

Revision 1.6, Sat Jun 9 11:27:38 2012 UTC (13 years, 1 month ago) by kristaps
Branch: MAIN
Changes since 1.5: +2 -2 lines
FILE REMOVED

Remove catman(8): it's superfluous.
Users of man.cgi should be able to just copy in their directories and have
the CGI fine everything on its own or just suck it up or, in the cases
of multiple manroots, have a simple config file.
Besides, now that mandocdb(8) is using relative paths for everything,
needing a fancy "cp -R" is silly.

Revision 1.5 / (download) - annotate - [select for diffs], Sun Dec 25 19:35:44 2011 UTC (13 years, 6 months ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_12_3, VERSION_1_12_2, VERSION_1_12_1
Branch point for: VERSION_1_12
Changes since 1.4: +16 -16 lines
Diff to previous 1.4 (colored) to selected 1.7 (colored)

State default usage before listing arguments of a utility.  Inspired by a
patch to mandocdb.8 by schwarze@ some time ago.  Ok jmc@.

Revision 1.4 / (download) - annotate - [select for diffs], Sat Dec 24 22:37:16 2011 UTC (13 years, 6 months ago) by kristaps
Branch: MAIN
Changes since 1.3: +14 -3 lines
Diff to previous 1.3 (colored) to selected 1.7 (colored)

Support leading, trailing and double colons in MANPATH to prepend,
append or insert the man.conf(5) default path; compatible with GNU
manpath(1), implementation by kristaps@, heavily tweaked by schwarze@.

Updates to MANPATH documentation applied to whatis.1, apropos.1, and
catman.8 also.

Revision 1.3 / (download) - annotate - [select for diffs], Sun Dec 18 18:51:01 2011 UTC (13 years, 6 months ago) by kristaps
Branch: MAIN
Changes since 1.2: +19 -3 lines
Diff to previous 1.2 (colored) to selected 1.7 (colored)

Give catman(8) the -C flag (like apropos and friends) and merge in some
documentation from apropos(1) to be consistent.

Revision 1.2 / (download) - annotate - [select for diffs], Sun Dec 4 22:52:50 2011 UTC (13 years, 7 months ago) by kristaps
Branch: MAIN
Changes since 1.1: +5 -3 lines
Diff to previous 1.1 (colored) to selected 1.7 (colored)

Make catman and man.cgi understand the index type-field.
Also make catman's man.conf be generated as catman.conf to avoid clobbering
a real man.conf file.
Finally, add a placeholder catman() function to man.cgi for preformatted
manuals in the cache.

Revision 1.1 / (download) - annotate - [select for diffs], Sat Nov 26 19:54:13 2011 UTC (13 years, 7 months ago) by kristaps
Branch: MAIN
Diff to selected 1.7 (colored)

Rename manup(8) to catman(8), which Linux already uses for a similar tool.

This form allows you to request diff's between any two revisions of a file. You may select a symbolic revision name using the selection box or you may type in a numeric name using the type-in text box.




CVSweb