Commit graph

15 commits

Author SHA1 Message Date
Simon L. B. Nielsen
c952bef273 - Add support for Pp command - this improves output for axe(4).
- Add support for .Fx, just in case somebody starts using it.
- Only add the arch information to the first para per manual page.
  This improves output for axe(4), and generally seems to make sense
  (I hope).
- Remove an unneeded line for non-compat mode.
2008-10-05 09:45:45 +00:00
Bruce A. Mah
aebd313860 Add support for auto-generating hardware notes entries in a
manner consistent with the new MI-style hardware notes document.

man2hwnotes.pl now defaults to generating entities for the MI-style
hardware notes (i.e. hardware/article.sgml).  A new -c
option causes it to generate entities for the older MD-style
hardware notes (i.e. hardware/common/dev.sgml).

The Makefile infrastructure supplies the -c option to man2hwnotes.pl
now unless the HWNOTES_MI Makefile variable is defined, so
compatiblity is preserved for hardware notes translations that
aren't converted to the new organization yet.  As translations
convert, they should define HWNOTES_MI in their hardware/Makefile.
When all the relevant translations catch up, the compatibility goop
in share/mk/doc.relnotes.mk and share/sgml/Makefile can be removed.

Thanks go to simon@ for help with the backwards compatiblity
mechanism.

Tested with:	en_US.ISO8859-1, zh_CN.GB2312
2007-02-16 02:10:12 +00:00
Simon L. B. Nielsen
7777167df0 - Add more debugging information to make it simpler to understand
what's going on in cases where the "state engine" doesn't act as
  expected, e.g. in the case of a list not being closed in the manual
  page being parsed.
- Bump copyright year.

MFC after:	1 week
2006-07-28 20:23:03 +00:00
Simon L. B. Nielsen
5248e0694d Handle .Li macro's with quoted arguments, which is used in the ath(4)
manual page.

Noticed by:	brueffer (long ago)
Approved by:	re (hrs)
2005-07-04 07:48:02 +00:00
Simon L. B. Nielsen
8dd33b6c68 - Update usage to reflect the current reality.
- Fix a bug where manual pages which had a "_" in their name did not
  get proper architecture setting.

MFC after:	1 week
2004-12-14 13:07:58 +00:00
Simon L. B. Nielsen
043c780ab0 Make a warning less cryptic. 2004-09-11 15:14:13 +00:00
Simon L. B. Nielsen
6b7e211c1a Make sure ampersand is encoded as & since jade seems to be confused
when it is encoded as & inside an entity.

MFC after:	3 days
2004-09-04 20:40:15 +00:00
Simon L. B. Nielsen
bc0b4ff69c - Improve handling of trailing punctuation characters for the Xr macro.
MFC after:	3 days
2004-08-27 21:32:24 +00:00
Simon L. B. Nielsen
401528f8f8 - For column lists: ignore first item when it is likely to be a header.
- Clean up and improve handling of trailing punctuation characters.
- Handle the Pa macro.
- Give a warning when ignoring unimplemented mdoc commands.

MFC after:	3 days
2004-08-27 19:29:21 +00:00
Hiroki Sato
e5bcf939e4 s/_/./g for an entity name.
Reviewed by:    simon
2004-08-26 08:52:46 +00:00
Simon L. B. Nielsen
a733008573 Support column lists, by only extracting the first column.
MFC after:	3 days
2004-08-25 23:32:26 +00:00
Simon L. B. Nielsen
54597ca9b2 - Handle the '\&' mdoc(7) escape sequence.
- Handle the .Sx macro and give a warning if it is used in the
  HARDWARE section, since that will probably produce odd text in the
  Hardware Notes.
2004-08-15 22:33:10 +00:00
Simon L. B. Nielsen
93fceccc94 - Add support for the .Dq macro. 2004-08-08 21:28:00 +00:00
Hiroki Sato
293283dc5b - Add an -o option to specify the output file.
- Make "die()" more verbose.
- Do not put extra blank lines into the output file.
- Normalize text by using numeric entities because
  some characters such as "'" can break the generated SGML.

Reviewed by:	simon
2004-08-08 09:23:49 +00:00
Simon L. B. Nielsen
4e702f5b14 Auto generate the device listings in the Hardware Notes based on
manual pages, to avoid duplicating work between the Hardware Notes and
manual pages.

Each text line in the output from the manual page parser is generated
as a SGML entity, making it possible for translators to only translate
lines which actually contains English text (this neat idea came from
hrs).

To determine which drivers are usable on which architectures the
dev.archlist.txt file is used to explicitly list this.  It it an
imperfect solution, but the best I have been able to come up with for
now.

This commit converts most of the devices which has a section 4 manual
page with a HARDWARE section to be the new auto generated format.

Reviewed in principle by:	ru, hrs, trhodes
Good ideas for improvements:	hrs
No objections:			-doc, re
2004-08-03 22:12:45 +00:00