OpenBSD CVS

CVS log for src/usr.bin/mandoc/Attic/mdoc.7


[BACK] Up to [local] / src / usr.bin / mandoc

Request diff between arbitrary revisions


Default branch: MAIN


Revision 1.44, Sun Aug 1 20:37:51 2010 UTC (13 years, 9 months ago) by schwarze
Branch: MAIN
CVS Tags: HEAD
Changes since 1.43: +2 -2 lines
FILE REMOVED

Move the new mdoc(7) manual written by kristaps@, replacing the old one
which had much less information, such that the new one gets installed.
No change to the build system required, no text change in this commit.
Doing the big move early even though a few more improvements will follow.
The duplicate information in mdoc.samples(7) will be cleaned up post-release.
ok jmc@, and kristaps@ agreed with the plan, too

Revision 1.43 / (download) - annotate - [select for diffs], Sun Aug 1 00:09:48 2010 UTC (13 years, 9 months ago) by schwarze
Branch: MAIN
Changes since 1.42: +7 -25 lines
Diff to previous 1.42 (colored)

Sync to bsd.lv:
State that we parse and ignore \s and \m font size and colour control
sequences, and remove the detailed, irrelevant documentation.

Revision 1.42 / (download) - annotate - [select for diffs], Sat Jul 31 22:07:11 2010 UTC (13 years, 9 months ago) by schwarze
Branch: MAIN
Changes since 1.41: +240 -226 lines
Diff to previous 1.41 (colored)

Major cleanup (but there is still more to come):
* rewrite .An, .Bd, .Bk, .Bl, .Ex descriptions
* correct "parsable" to "parsed"
* and various formatting and wording tweaks
This commit includes a patch from kristaps@ explaining empty .Dd.
Feedback and OK jmc@ and kristaps@.

Revision 1.41 / (download) - annotate - [select for diffs], Sun Jul 25 18:05:54 2010 UTC (13 years, 9 months ago) by schwarze
Branch: MAIN
Changes since 1.40: +342 -129 lines
Diff to previous 1.40 (colored)

Sync to bsd.lv; in particular, pull in lots of bug fixes.
new features:
* support the .in macro in man(7)
* support minimal PDF output
* support .Sm in mdoc(7) HTML output
* support .Vb and .nf in man(7) HTML output
* complete the mdoc(7) manual
bug fixes:
* do not let mdoc(7) .Pp produce a newline before/after .Sh; reported by jmc@
* avoid double blank lines related to man(7) .sp and .br
* let man(7) .nf and .fi flush the line; reported by jsg@ and naddy@
* let "\ " produce a non-breaking space; reported by deraadt@
* discard \m colour escape sequences; reported by J.C. Roberts
* map undefined 1-character-escapes to the literal character itself
maintenance:
* express mdoc(7) arguments in terms of an enum for additional type-safety
* simplify mandoc_special() and a2roffdeco()
* use strcspn in term_word() in place of a manual loop
* minor optimisations in the -Tps and -Thtml formatting frontends

Revision 1.40 / (download) - annotate - [select for diffs], Thu Jul 15 23:46:58 2010 UTC (13 years, 10 months ago) by schwarze
Branch: MAIN
Changes since 1.39: +14 -2 lines
Diff to previous 1.39 (colored)

document .Sm; prodded by kristaps@

Revision 1.39 / (download) - annotate - [select for diffs], Tue Jul 13 01:09:13 2010 UTC (13 years, 10 months ago) by schwarze
Branch: MAIN
Changes since 1.38: +217 -26 lines
Diff to previous 1.38 (colored)

Merge release 1.10.4 (all code by kristaps@), providing four new features:
1) Proper .Bk support: allow output line breaks at input line breaks,
but keep input lines together in the output, finally fixing
synopses like aucat(1), mail(1) and tmux(1).
2) Mostly finished -Tps (PostScript) output.
3) Implement -Thtml output for .Nm blocks and .Bk -words.
4) Allow iterative interpolation of user-defined roff(7) strings.
Also contains some minor bugfixes and some performance improvements.

Revision 1.38 / (download) - annotate - [select for diffs], Thu Jul 1 15:36:59 2010 UTC (13 years, 10 months ago) by schwarze
Branch: MAIN
Changes since 1.37: +62 -2 lines
Diff to previous 1.37 (colored)

Improve .Nm indentation in the SYNOPSIS;
kristaps@ will do the missing HTML part soon.
"looks nicer" jmc@
"seems perfect to me" sobrado@
"slap it in" kristaps@

Revision 1.37 / (download) - annotate - [select for diffs], Sun Jun 27 13:33:43 2010 UTC (13 years, 10 months ago) by schwarze
Branch: MAIN
Changes since 1.36: +23 -2 lines
Diff to previous 1.36 (colored)

Document .Bk/.Ek; reminded by kristaps@.

Revision 1.36 / (download) - annotate - [select for diffs], Sat Jun 26 17:56:43 2010 UTC (13 years, 10 months ago) by schwarze
Branch: MAIN
Changes since 1.35: +12 -13 lines
Diff to previous 1.35 (colored)

merge release 1.10.2
* bug fixes:
- interaction of ASCII_HYPH with special chars (found by Ulrich Spoerlein)
- handling of roff conditionals (found by Ulrich Spoerlein)
- .Bd -offset will no more default to 6n
* maintenance:
- more caching of .Bd and .Bl arguments for efficiency
- deconstify man(7) validation routines
- add FreeBSD library names (provided by Ulrich Spoerlein)
* start PostScript font-switching

Revision 1.35 / (download) - annotate - [select for diffs], Tue Jun 8 00:11:47 2010 UTC (13 years, 11 months ago) by schwarze
Branch: MAIN
Changes since 1.34: +56 -55 lines
Diff to previous 1.34 (colored)

Merge more bits that will be going into 1.10.1:

Clean up vertical spacing in the SYNOPSIS, making the code much more
systematic; this doesn't solve all SYNOPSIS problems yet, in particular
not those related to keeps, indentation and the low-level .nr roff
instruction, but it's a nice step forward and i couldn't find relevant
regressions.  (from kristaps)

Besides,
* make the output width configurable (default: -Owidth=80) (kristaps)
* use mmap with MAP_SHARED (from Joerg Sonnenberger)

Revision 1.34 / (download) - annotate - [select for diffs], Sun Jun 6 20:30:08 2010 UTC (13 years, 11 months ago) by schwarze
Branch: MAIN
Changes since 1.33: +341 -46 lines
Diff to previous 1.33 (colored)

Merge bsd.lv version 1.10.1 (to be released soon).

The main step forward is that this now has *much* better .Bl -column
support, now supporting many manuals that previously errored out
without producing any output.

Other fixes include:
* do not die from multiple list types, use the first and warn
* in .Bl without a type, default to -item
* various tweaks to .Dt
* fix .In, .Fd, .Ft, .Fn and .Fo formatting
* some documentation fixes and additions
* and fix a couple of bugs reported by Ulrich Spoerlein:
* better support for roff block-end "\}" without a preceding dot
* .In must not break the line outside SYNOPSIS
* spelling in some error messages

While merging, fix one regression in .In spacing
that needs to go to bsd.lv, too.

Revision 1.33 / (download) - annotate - [select for diffs], Sun Jun 6 18:08:41 2010 UTC (13 years, 11 months ago) by schwarze
Branch: MAIN
Changes since 1.32: +29 -3 lines
Diff to previous 1.32 (colored)

Merge bsd.lv release 1.10.0,
which is mostly the post-hackathon release,
bringing in the OpenBSD changes to bsd.lv,
but which also has a few additional minor fixes:

* .Lb is an in-line macro, not in_line_eoln
* .Bt, .Ud now warn when discarding arguments
* allow bad -man dates to flow verbatim into the front-ends
- so far all reported by Ulrich Spoerlein
* .Ar, .Fl and .Li starting with closing punctuation emit an empty element
* empty .Li macros print nothing, but may cause spacing
* proper EOS handling for .Bt, .Ex, .Rv, and .Ud.
* cleanup: collapse posts_xr into posts_wtext (which is the same)
* efficiency: very simple table lookup for roff.c

Revision 1.32 / (download) - annotate - [select for diffs], Sun May 16 02:06:50 2010 UTC (14 years ago) by schwarze
Branch: MAIN
Changes since 1.31: +108 -55 lines
Diff to previous 1.31 (colored)

sync to bsd.lv: enable .Bl documentation

Revision 1.31 / (download) - annotate - [select for diffs], Sat May 15 18:25:50 2010 UTC (14 years ago) by schwarze
Branch: MAIN
Changes since 1.30: +3 -3 lines
Diff to previous 1.30 (colored)

allow non-numeric manual sections in -mdoc;
while here, allow LIBRARY in section 9;
by kristaps@

Revision 1.30 / (download) - annotate - [select for diffs], Sat May 15 16:48:12 2010 UTC (14 years ago) by schwarze
Branch: MAIN
Changes since 1.29: +10 -3 lines
Diff to previous 1.29 (colored)

various improvements regarding errors and warnings Joerg Sonnenberger:
* If the last -column .Bl isn't specified, it is auto-sized.
* An invalid .St argument should be a warning, not an error.
  Just put the argument into the output.
* An invalid .At argument should be a warning, not an error.
  Just print the argument, like new groff does.
* Remove warnings concerning manual section (like 1, 6, 8).
  It was only used for .Ex and not really useful.
* Remove warnings concerning page section (like SYNOPSIS).
  These were only used for .Fd and .Lb and not really useful.

Revision 1.29 / (download) - annotate - [select for diffs], Sat May 15 15:37:53 2010 UTC (14 years ago) by schwarze
Branch: MAIN
Changes since 1.28: +13 -2 lines
Diff to previous 1.28 (colored)

more end-of-sentence (EOS) handling:
* recognize the end of quoted sentences, and of those in parantheses
* detect EOS in append_delims, so it works after all macros
by kristaps@

Revision 1.28 / (download) - annotate - [select for diffs], Fri May 14 19:52:43 2010 UTC (14 years ago) by schwarze
Branch: MAIN
Changes since 1.27: +7 -1 lines
Diff to previous 1.27 (colored)

Integrate kristaps@' end-of-sentence (EOS) framework
which is simpler and more powerful than mine, and remove mine.

* man(7) now has EOS handling, too
* put EOS detection into its own function in libmandoc
* use node and termp flags to communicate the EOS condition
* no more EOS pseudo-macro
* no more non-printable EOS marker character on the formatter level

This slightly breaks EOS detection after trailing punctuation
in mdoc(7) macros, but that will be restored soon.

Revision 1.27 / (download) - annotate - [select for diffs], Fri May 14 14:47:44 2010 UTC (14 years ago) by schwarze
Branch: MAIN
Changes since 1.26: +206 -155 lines
Diff to previous 1.26 (colored)

Merge 1.9.25, keeping local patches;
this does not merge kristaps' end-of-sentences handling yet,
i will check that separately.  This one includes:
* handle \*(Ba as a delimiter
* introduce ARGS_PEND for .Bl -column .It end-of-line special casing
* section ordering: expect EXIT STATUS at the right place
* line break fixes in SYNOPSIS
* allow literal contexts to have arbitrary line lengths
* the input file column number can not be used to identify the beginning
  of a line because white space is allowed after the initial '.'
* proper leading spaces in -man -Tascii mode
* do not let Lb break lines in -mdoc -Thtml LIBRARY

Revision 1.26 / (download) - annotate - [select for diffs], Fri May 14 01:54:37 2010 UTC (14 years ago) by schwarze
Branch: MAIN
Changes since 1.25: +47 -205 lines
Diff to previous 1.25 (colored)

merge 1.9.24, keeping local patches; some changes:
* preserve multiple consecutive space characters in input
* do not restrict .Cd and .Rv to certain sections (requested by Joerg)
* do not run lookup() on quoted words
* enum return types for mdoc_args and mdoc_argv
* fix auto-closing of LINK tag in -Txhtml (from Daniel Friesel)
* various lint and manual fixes

Revision 1.25 / (download) - annotate - [select for diffs], Wed Apr 7 23:15:05 2010 UTC (14 years, 1 month ago) by schwarze
Branch: MAIN
Changes since 1.24: +73 -133 lines
Diff to previous 1.24 (colored)

Merge the good parts of 1.9.23,
avoid the bad parts of 1.9.23, and keep local patches.

Input in general:
 * Basic handling of roff-style font escapes \f, \F.
 * Quoted punctuation does not count as punctuation.

mdoc(7) parser:
 * Make .Pf callable; noted by Claus Assmann.
 * Let .Bd and .Bl ignore unknown arguments; noted by deraadt@.
 * Do not warn when .Er is used outside certain sections.
 * Replace mdoc_node_free[list] by mdoc_node_delete.
 * Replace #define by enum for rew*() return values.

man(7) parser:
 * When .TH is missing, use default section and date.

Output in general:
 * Curly braces do not count as punctuation.
 * No space after .Fl w/o args when a macro follows on the same line.

HTML output:
 * Unify PAIR_*_INIT macros, introduce new PAIR_ID_INIT().
 * Print whitespace after, not before .Vt .Fn .Ft .Fo.

Checked that all manuals in base still build.

Revision 1.24 / (download) - annotate - [select for diffs], Fri Apr 2 12:39:47 2010 UTC (14 years, 1 month ago) by schwarze
Branch: MAIN
Changes since 1.23: +9 -2 lines
Diff to previous 1.23 (colored)

merge 1.9.22, keeping local patches
* convert mdoc tokens from #define to enum
* fix a segfault with .Xo/.Xc in explicit blocks
* Thorn is \*(Th, not \*(TH; noticed by Joerg Sonnenberger

Revision 1.23 / (download) - annotate - [select for diffs], Fri Feb 26 12:51:25 2010 UTC (14 years, 2 months ago) by schwarze
Branch: MAIN
CVS Tags: OPENBSD_4_7_BASE, OPENBSD_4_7
Changes since 1.22: +3 -2 lines
Diff to previous 1.22 (colored)

Old news: there is an experimental "loongson" port.
This commit corresponds to what jmc@ did in share/tmac/mdoc/doc-common
and share/man/man7/mdoc.samples.7 on January 24.

Revision 1.22 / (download) - annotate - [select for diffs], Thu Feb 18 02:11:26 2010 UTC (14 years, 3 months ago) by schwarze
Branch: MAIN
Changes since 1.21: +82 -24 lines
Diff to previous 1.21 (colored)

sync to release 1.9.15:
 * corrected .Vt handling (spotted by Joerg Sonnenberger)
 * corrected .Xr argument handling (based on my patch)
 * removed \\ escape sequence (because it is for low-level roff only)
 * warn about trailing whitespace (suggested by jmc@)
 * -Txhtml support
 * and some general cleanup and doc improvements

Revision 1.21 / (download) - annotate - [select for diffs], Sat Jan 2 02:42:06 2010 UTC (14 years, 4 months ago) by schwarze
Branch: MAIN
Changes since 1.20: +107 -7 lines
Diff to previous 1.20 (colored)

complete the sync to 1.9.15-pre2: mostly minor fixes
 * bugfix: do not restore TERMP flags when leaving lists, just reset them
 * and a few HTML fixes
 * clarity: return width from a2width, not width+2, and adapt to it
 * manual: document .Bl and .Fl
 * portability: no need to escape '%' in macro names

Revision 1.20 / (download) - annotate - [select for diffs], Thu Dec 24 02:08:14 2009 UTC (14 years, 4 months ago) by schwarze
Branch: MAIN
Changes since 1.19: +57 -8 lines
Diff to previous 1.19 (colored)

sync to 1.9.14: rewrite escape sequence handling:
- new function a2roffdeco
- font modes (\f) only affect the current stack point
- implement scaling (\s)
- implement space suppression (\c)
- implement non-breaking space (\~) in -Tascii
- many manual improvements

Revision 1.19 / (download) - annotate - [select for diffs], Wed Dec 23 22:30:17 2009 UTC (14 years, 4 months ago) by schwarze
Branch: MAIN
Changes since 1.18: +190 -54 lines
Diff to previous 1.18 (colored)

sync to 1.9.13: minor fixes:

correctness/functionality:
 - bugfix: properly ignore lines with only a dot in -man
 - bugfix: .Bl -ohang doesn't allow -width, warn about this
 - improve date string handling by new function mandoc_a2time
 - some HTML improvements
 - significant documentation additions in man.7 and mdoc.7

portability:
 - replace __dead by __attribute__((noreturn))
 - bugfix: correct .Dx rendering
 - some more library names for NetBSD

simplicity:
 - replace hand-rolled putchar(3)-loops by fwrite(3)
 - replace single-character printf(3) by putchar(3)

Revision 1.18 / (download) - annotate - [select for diffs], Tue Oct 27 21:40:07 2009 UTC (14 years, 6 months ago) by schwarze
Branch: MAIN
Changes since 1.17: +22 -4 lines
Diff to previous 1.17 (colored)

sync to 1.9.11: adapt printing of dates to groff conventions,
NetBSD portability fixes and some minor bugfixes and feature enhancements;
also checked that my hyphenation code still works on top of this

Revision 1.17 / (download) - annotate - [select for diffs], Wed Oct 21 19:13:50 2009 UTC (14 years, 7 months ago) by schwarze
Branch: MAIN
Changes since 1.16: +1333 -237 lines
Diff to previous 1.16 (colored)

sync to 1.9.9, featuring:
 * -Thtml output mode
 * roff scaling units
 * and some minor fixes
for full changelogs, see http://bsd.lv/cgi-bin/cvsweb.cgi/

Revision 1.16 / (download) - annotate - [select for diffs], Mon Oct 19 20:44:35 2009 UTC (14 years, 7 months ago) by schwarze
Branch: MAIN
Changes since 1.15: +3 -3 lines
Diff to previous 1.15 (colored)

sync to 1.9.7: compatibility fix; from joerg at netbsd dot org

Revision 1.15 / (download) - annotate - [select for diffs], Sat Aug 22 23:17:40 2009 UTC (14 years, 8 months ago) by schwarze
Branch: MAIN
Changes since 1.14: +405 -352 lines
Diff to previous 1.14 (colored)

another large chunk of -man updates,
among others regarding .DT, .HP, .RS, .RE, .SH, .SS, and scoping,
now in sync vith release 1.9.1

Revision 1.14 / (download) - annotate - [select for diffs], Sat Aug 22 19:45:39 2009 UTC (14 years, 9 months ago) by schwarze
Branch: MAIN
Changes since 1.13: +405 -413 lines
Diff to previous 1.13 (colored)

sync to 1.9.0: improve documentation of parsed and callable macros;
the diff is large because kristaps@ reindented macro calls

Revision 1.13 / (download) - annotate - [select for diffs], Sat Aug 22 16:41:45 2009 UTC (14 years, 9 months ago) by schwarze
Branch: MAIN
Changes since 1.12: +36 -31 lines
Diff to previous 1.12 (colored)

sync to 1.8.5: clean up sections describing escape sequences

Revision 1.12 / (download) - annotate - [select for diffs], Sat Aug 22 15:44:02 2009 UTC (14 years, 9 months ago) by schwarze
Branch: MAIN
Changes since 1.11: +9 -1 lines
Diff to previous 1.11 (colored)

sync to 1.8.4: The .St -p1003.1* macros produce "POSIX" instead of "POSIX.1";
agreed with jmc@ to leave this for now (because it agrees with our in-tree
groff) and adapt it to new groff conventions after the main switch

Revision 1.11 / (download) - annotate - [select for diffs], Sun Aug 9 21:59:41 2009 UTC (14 years, 9 months ago) by schwarze
Branch: MAIN
Changes since 1.10: +12 -2 lines
Diff to previous 1.10 (colored)

sync to 1.8.4: full .An -[no]split support

Revision 1.10 / (download) - annotate - [select for diffs], Sun Aug 9 16:36:45 2009 UTC (14 years, 9 months ago) by schwarze
Branch: MAIN
Changes since 1.9: +3 -3 lines
Diff to previous 1.9 (colored)

sync to 1.8.1: make .Cd parsed
kristaps@ says many SYNOPSIS sections use this; my impression is
that's not in OpenBSD, but it won't do much harm here, either

Revision 1.9 / (download) - annotate - [select for diffs], Sun Jul 26 23:18:08 2009 UTC (14 years, 9 months ago) by schwarze
Branch: MAIN
Changes since 1.8: +204 -252 lines
Diff to previous 1.8 (colored)

sync to 1.8.1: describe corrected handling of quoted literals,
remove trailing whitespace and much minor cleanup

Revision 1.8 / (download) - annotate - [select for diffs], Sat Jul 18 21:03:18 2009 UTC (14 years, 10 months ago) by schwarze
Branch: MAIN
Changes since 1.7: +390 -397 lines
Diff to previous 1.7 (colored)

sync to 1.8.0: lots of minor changes

Revision 1.7 / (download) - annotate - [select for diffs], Tue Jul 7 00:10:44 2009 UTC (14 years, 10 months ago) by schwarze
Branch: MAIN
Changes since 1.6: +43 -17 lines
Diff to previous 1.6 (colored)

sync to 1.7.21:
document the \fX escapes (not recommended)
add some more details about escape sequences
document white space handling
simplify some explanations, don't talk about ontologies

Revision 1.6 / (download) - annotate - [select for diffs], Wed Jun 24 00:16:52 2009 UTC (14 years, 10 months ago) by schwarze
Branch: MAIN
CVS Tags: OPENBSD_4_6_BASE, OPENBSD_4_6
Changes since 1.5: +22 -3 lines
Diff to previous 1.5 (colored)

sync to 1.7.20: minimum requirements for -mdoc documents;
while merging, avoid having two STRUCTURE sections;
the fix for the latter problem was also submitted upstream

Revision 1.5 / (download) - annotate - [select for diffs], Sun Jun 21 19:09:58 2009 UTC (14 years, 11 months ago) by schwarze
Branch: MAIN
Changes since 1.4: +4 -4 lines
Diff to previous 1.4 (colored)

sync to 1.7.19: .Bl -column  now correctly handles tail entries,
for example:  .Bl -column -compact -offset ... args ...

Revision 1.4 / (download) - annotate - [select for diffs], Thu Jun 18 23:34:53 2009 UTC (14 years, 11 months ago) by schwarze
Branch: MAIN
Changes since 1.3: +12 -2 lines
Diff to previous 1.3 (colored)

sync to 1.7.19: improved comment handling

Revision 1.3 / (download) - annotate - [select for diffs], Thu Jun 18 01:19:02 2009 UTC (14 years, 11 months ago) by schwarze
Branch: MAIN
Changes since 1.2: +42 -33 lines
Diff to previous 1.2 (colored)

sync to 1.7.16: make a couple of macros callable, reserve "|",
and some tweaks to .Lk

Revision 1.2 / (download) - annotate - [select for diffs], Sun Jun 14 23:00:57 2009 UTC (14 years, 11 months ago) by schwarze
Branch: MAIN
Changes since 1.1: +15 -17 lines
Diff to previous 1.1 (colored)

sync to 1.7.16: comments, whitespace and spelling fixes; no functional change

Revision 1.1 / (download) - annotate - [select for diffs], Mon Apr 6 20:30:40 2009 UTC (15 years, 1 month ago) by kristaps
Branch: MAIN

Initial check-in of mandoc for formatting manuals. ok deraadt@

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.