CHANGES for man2html: 2024-01-05 20:11:41 MM/DD/YYYY =========================================================================== 2024-01-05 * change the special case of bold italics to "-mixsecs" option. =========================================================================== 2023-12-17 o allow a special case of bold italics (used in captoinfo.1m in ncurses) =========================================================================== 2023-12-02 o provide a special case for ncurses's main manpage, which now uses italics for the subsections defining environment variables, rather than bold. =========================================================================== 2023-03-19 o convert remaining tabs to spaces (perl tidy already did most). o reset variable used to splice links which are broken by hyphenation, if the bold text happens to not match the see-also pattern. This occurred with ncurses curs_refresh.3x.html file. o fix a case where optional pattern in substitution did not match, causing an uninitialized-variable warning. =========================================================================== 2022-07-14 o regenerate doc/man2html.html, doc/man2html.ps, doc/man2html.txt using makefile. o document all of the new options in doc/man2html.1 o some cleanup of man2html.1, eliminating unused macros and adding macros to replace repetitive nroff commands. o add doc/makefile =========================================================================== 2022-07-12 o amend the hyphenation fix to account for href's pointing to a subdirectory. improve handling of hyphenated link by adding an option "-leftside" for the left-sides from hyphenated manpage names (with a short fallback for "apt", "cvs", "git", "sccs' and "sysv"). =========================================================================== 2022-07-09 o adapt Schilling's subsection change (suggested by Robert Clausecker) =========================================================================== 2021-02-08 o trim unwanted quotes from -title parameter which came from shellcheck fixes =========================================================================== 2020-08-19 o provide for a special case of subsections used in mawk-code.7, where some are only two-characters. =========================================================================== 2018-01-01 o use https for website =========================================================================== 2017-01-07 o better mapping for aliases by not modifying the displayed link-text. =========================================================================== 2016-01-30 o if "-compress", suppress extra newline at the end of PRE-sections which added to whitespace on resulting page. =========================================================================== 2015-07-08 o add "-toc" option, used in vile's documentation =========================================================================== 2015-02-15 o make -title less obnoxious by using css "no-header" and omitting the following hr-tag from the h1-tag. =========================================================================== 2015-02-14 o another fix for index-levels o corrected logic for index levels =========================================================================== 2015-02-13 o add "-index" option, to move some functionality out of "fixup-man2html" o move the advert into the meta tag for "generator" as done with tidy. (verified that reformatting with tidy will not remove this tag) o modify heuristic for section-titles to allow it to match subsection titles (which differ only by their indent/margin value). o bump version o improve the fix to ensure there is no extra leading/trailing whitespace =========================================================================== 2015-02-12 o fix special case seen in ctlseqs.ms where a partially bold line would be treated as a header. The fix ensures that any non-punctuation/non-space character on the line is bold - the normal behavior for nroff. =========================================================================== 2014-12-20 o Hood's old website is long gone; the replacement on Savannah had no updates (other than his change to use cvs). Update the url to point to my site, which is the version I use for ncurses. =========================================================================== 2013-12-21 o sign my work. o for consistency, warn as I did for -externs o add "-aliases" option for ncurses o add "-externs" option for ncurses o stylistic - tell the number of params, for prototype o spelling fixes o isolated cause for uninitialized $fix variable which would be reported by "use diagnostics" or "use warnings" - ncurses output unchanged. o indented (with perltidy) o fix most of the warnings which come up with "use strict". However, turning on "use strict" will break ncurses' manhtml usage. =========================================================================== 2001-07-28 o keep the version number the same. o add a fix to detect if the text used for an HREF was hyphenated, and add the missing chunk. =========================================================================== 08/12/1997 (3.0.1) o man2html now checks for EOF in page processing loop. This helps if page size (or margins) is set to an extremely large value to, in effect, specify no pagination exists in input. If EOF checks are not made, man2html will appear to hang until it counts off the specified page size. o Modified man.cgi so the cgi-bin location can be specified in the configuration variable section. =========================================================================== 08/11/1997 (3.0.0) o Updated man2html code for Perl 5. Program no longer executable by Perl 4 interpreters. o New command-line options: -belem : HTML Element for overstriked text (def: "B") -cgiurlexp : Perl expression URL for linking to other manpages -compress : Compress consective blank lines -uelem : HTML Element for underlined text (def: "I") o Slightly stricter check on keyword search parsing to avoid abnormal lines. o Manpage references will be put in bold even if no CGI URL expression is specified. This behavior will be restricted to the SEE ALSO section if the -seealso option is specified. o man2html modified so it can be required from Perl programs instead of using system(): - man2html code under package Man2Html - exit() not called - Input and output filehandles can be specified before being required o man2html documentation now done in troff so it can be be installed as a manpage. HTML, text, and postscript versions are created from the manpage version. o Changes to man.cgi: - Updated to run properly under Perl 5. - Requires man2html instead of using system(). - Uses implicit fork through open() to invoke man program for better security. - List variables are used for specifying command-line options instead of strings. - Cosmetic UI changes to HTML form. o Put man2html files under SCCS revision control. =========================================================================== 12/22/95 (2.1.0) o The -cgiurl option is no longer required with the -k option. if -k is specified, man2html will process input as keyword search results, regardless. o Added a -solaris option (for lack of a better word). Solaris systems have a different keyword search output compared to other systems. Example: zcmp zcmp (1) - compare compressed files zdiff zcmp (1) - compare compressed files The topic appears first. Then the actual manpage of the topic is listed second. If your keyword search results look like this, then use the -solaris option. This option is only effective with the -k option. o Fixed bug when -nohead and -seealso are both specified. o Fixed bug in detecting overstriking. man2html was try to be clever about non-alpha characters within overstriked text, but it screwed up in other cases. The "cleverness" has been removed. o '+' characters are mapped to '%2B' in cross-ref URLs. o If -seealso is specified, all xrefs are detected after the SEE ALSO heading. I.e. Sections after SEE ALSO may contain hyperlinked xrefs. o Speed increase. The amount of increase will vary depending on the input. =========================================================================== 09/02/94 (2.0.2) o Add the -bare option (for lack of a better name). This will keep man2html from inserting the HTML, HEAD, BODY tags from the output. This is useful if used in a CGI script that wants to include the output from man2html into an HTML document. =========================================================================== 08/19/94 (2.0.1) o Fixed bug in not recognizing manpage cross-refs that had a combination of bold-overstriking, underline-overstriking, and plain text. o Fixed bug in not detecting a <, >, or & to convert to an entity if the character right before it was a <, >, or &. o Speed increase. =========================================================================== 07/18/94 (2.0.0 beta) o Support for processing output from 'man -k', i.e. a keyord search. Links are created for all manpages listed, and the manpages are sorted by section. o Can now properly detect manpage references containing '_', '.', '+' characters. =========================================================================== 07/15/94 o man2html supports the ability to link to other manpages. =========================================================================== Earl Hood, ehood@medusa.acs.uci.edu