CVS log for mandoc/mdoc.7

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

Request diff between arbitrary revisions


Default branch: MAIN


Revision 1.282 / (download) - annotate - [select for diffs], Thu Jun 25 20:45:09 2020 UTC (5 weeks, 6 days ago) by schwarze
Branch: MAIN
CVS Tags: HEAD
Changes since 1.281: +11 -5 lines
Diff to previous 1.281 (colored)

Briefly mention groff_mdoc(7) below SEE ALSO.  While both authoritative
manual pages document the same content, comparing can occasionally help
in cases of doubt, and some people may prefer one style, some the other.
While here, modernize a few .Lks from http:// to https://.
OK jmc@

Revision 1.281 / (download) - annotate - [select for diffs], Thu Feb 13 18:32:56 2020 UTC (5 months, 3 weeks ago) by schwarze
Branch: MAIN
Changes since 1.280: +4 -17 lines
Diff to previous 1.280 (colored)

Mention that the .Dd "date" argument is the date of the last change.
Triggered by a question from Jason A. Donenfeld.

While here, delete three COMPATIBILITY entries that i fixed some time ago.

Revision 1.280 / (download) - annotate - [select for diffs], Sun Jan 19 18:02:00 2020 UTC (6 months, 2 weeks ago) by schwarze
Branch: MAIN
Changes since 1.279: +48 -3 lines
Diff to previous 1.279 (colored)

Introduce a new mdoc(7) macro .Tg ("tag") to explicitly mark a place
as defining a term.  Please only use it when automatic tagging does
not work.  Manual page authors will not be required to add the new
macro; using it remains optional.  HTML output is still rudimentary
in this version and will be polished later.

Thanks to kn@ for reminding me that i have been considering since
BSDCan 2014 whether something like this might be useful.  Given
that possibilities of making automatic tagging better are running
out and there are still several situations where automatic tagging
cannot do the job, i think the time is now ripe.

Feedback and no objection from millert@; OK espie@ inoguchi@ kn@.

Revision 1.279 / (download) - annotate - [select for diffs], Mon Jul 15 19:20:30 2019 UTC (12 months, 3 weeks ago) by schwarze
Branch: MAIN
Changes since 1.278: +9 -2 lines
Diff to previous 1.278 (colored)

explain escaping of end-of-sentence characters;
missing info reported by Ian <ropers at gmail dot com> on misc@

Revision 1.278 / (download) - annotate - [select for diffs], Wed Apr 24 13:15:00 2019 UTC (15 months, 1 week ago) by schwarze
Branch: MAIN
Changes since 1.277: +12 -10 lines
Diff to previous 1.277 (colored)

clarify the difference between .Cm and .Ic;
triggered by a question from Fabio Scotoni

Revision 1.277 / (download) - annotate - [select for diffs], Tue Apr 23 18:46:06 2019 UTC (15 months, 2 weeks ago) by schwarze
Branch: MAIN
Changes since 1.276: +10 -3 lines
Diff to previous 1.276 (colored)

clarify how .%P is conventionally used;
triggered by a question from Fabio Scotoni <fabio at esse dot ch>

Revision 1.276 / (download) - annotate - [select for diffs], Thu Feb 7 15:45:53 2019 UTC (17 months, 4 weeks ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_14_5
Changes since 1.275: +4 -6 lines
Diff to previous 1.275 (colored)

style improvement from jmc@, no output change;
original commit message:
.Pp
.Bd ... -compact

is better written as

.Bd ...

Revision 1.275 / (download) - annotate - [select for diffs], Wed Feb 6 22:18:59 2019 UTC (17 months, 4 weeks ago) by schwarze
Branch: MAIN
Changes since 1.274: +3 -3 lines
Diff to previous 1.274 (colored)

Remove the misleading statement ".No takes no arguments".
In facts, i works very similarly to .Em and .Sy.
Triggered by a question from Kurt Mosiejczuk <kurt at cranky dot work>.

Revision 1.274 / (download) - annotate - [select for diffs], Sun Dec 23 22:03:32 2018 UTC (19 months, 1 week ago) by schwarze
Branch: MAIN
Changes since 1.273: +683 -796 lines
Diff to previous 1.273 (colored)

Finally, stop abusing .Ss and .Sx to mark up macros, use .Ic instead
since these are clearly commands in a domain-specific language.  As
a nice side effect, the resulting list allows including the synopsis
for each macro in the item head, reducing some repetitive verbiage.

Revision 1.273 / (download) - annotate - [select for diffs], Sun Dec 23 16:55:34 2018 UTC (19 months, 1 week ago) by schwarze
Branch: MAIN
Changes since 1.272: +22 -36 lines
Diff to previous 1.272 (colored)

Simplify and clarify instructions for .Ql, and deprecate .Li.
The macros .Ql, .Dl, and .Bd -literal leave no room for any
valid use case for .Li whatsoever.
General direction discussed with jmc@.

Revision 1.272 / (download) - annotate - [select for diffs], Sun Dec 23 15:32:31 2018 UTC (19 months, 1 week ago) by schwarze
Branch: MAIN
Changes since 1.271: +4 -4 lines
Diff to previous 1.271 (colored)

Deprecate .Lp, use .Pp instead.
Simplicity matters, and fewer macros is simpler.
OK jmc@

Revision 1.271 / (download) - annotate - [select for diffs], Sat Jul 28 18:34:15 2018 UTC (2 years ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_14_4
Changes since 1.270: +6 -6 lines
Diff to previous 1.270 (colored)

Issue a STYLE message when normalizing the date format in .Dd/.TH.
Leah Neukirchen pointed out that mdoclint(1) used to warn about a
leading zero before the day number, so we know that both NetBSD and
Void Linux want the message.  It does no harm on OpenBSD because
Mdocdate always does the right thing anyway.
jmc@ agrees that it makes sense in contexts not using Mdocdate.

Revision 1.270 / (download) - annotate - [select for diffs], Mon Oct 23 13:54:41 2017 UTC (2 years, 9 months ago) by schwarze
Branch: MAIN
Changes since 1.269: +41 -17 lines
Diff to previous 1.269 (colored)

Modernize documentation of .Ao and .Aq.

I looked through our whole tree and failed to find a single use
that is really convincing, except those with .Mt.  Putting it around
character and key names is somewhat widespread and maybe acceptable,
even if hardly useful.

So for now, delete the bogus examples and explain what these macros
are really used for.  Discourage the most common abuses.

Triggered by a question from Raf Czlonka <rczlonka at gmail dot com>.

Revision 1.269 / (download) - annotate - [select for diffs], Thu Jul 20 16:24:53 2017 UTC (3 years ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_14_3, VERSION_1_14_2
Changes since 1.268: +3 -3 lines
Diff to previous 1.268 (colored)

more renaming from mdocml to mandoc

Revision 1.268 / (download) - annotate - [select for diffs], Wed Jul 5 12:25:17 2017 UTC (3 years, 1 month ago) by schwarze
Branch: MAIN
Changes since 1.267: +5 -5 lines
Diff to previous 1.267 (colored)

nits about trailing punctuation found with mandoc -Tlint

Revision 1.267 / (download) - annotate - [select for diffs], Thu Jun 29 13:17:00 2017 UTC (3 years, 1 month ago) by schwarze
Branch: MAIN
Changes since 1.266: +5 -5 lines
Diff to previous 1.266 (colored)

Clarify that .Ta as a line macro is a portability problem,
even though mandoc(1) handles it;
triggered by a question from Yuri Pankov (illumos).

Revision 1.266 / (download) - annotate - [select for diffs], Sat Jun 24 13:49:29 2017 UTC (3 years, 1 month ago) by schwarze
Branch: MAIN
Changes since 1.265: +2 -7 lines
Diff to previous 1.265 (colored)

Delete .St -p1003.1-2013.
It is an OpenBSD addition that did not get used a single time in
three years, and groff did not pick it up either, so removing it
does not affect any existing manuals anywhere.
Cleanup suggested by jmc@, OK bentley@.

Revision 1.265 / (download) - annotate - [select for diffs], Sat Jun 10 16:32:27 2017 UTC (3 years, 1 month ago) by schwarze
Branch: MAIN
Changes since 1.264: +2 -2 lines
Diff to previous 1.264 (colored)

minor markup simplifications

Revision 1.264 / (download) - annotate - [select for diffs], Fri May 5 15:54:59 2017 UTC (3 years, 3 months ago) by schwarze
Branch: MAIN
Changes since 1.263: +2 -19 lines
Diff to previous 1.263 (colored)

Shorten the description of .sp and move it to roff(7).
If is not a macro but a low-level roff request
and not recommended for use in manual pages.

Revision 1.263 / (download) - annotate - [select for diffs], Fri May 5 02:31:35 2017 UTC (3 years, 3 months ago) by schwarze
Branch: MAIN
Changes since 1.262: +2 -12 lines
Diff to previous 1.262 (colored)

Clean up docs after today's .br and .ft code cleanup; simpler.

Revision 1.262 / (download) - annotate - [select for diffs], Thu Feb 16 14:38:12 2017 UTC (3 years, 5 months ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_14_1, VERSION_1_13
Changes since 1.261: +4 -6 lines
Diff to previous 1.261 (colored)

Surprisingly, groff does not support scaling units in .Bl -column
column width specifiers, so stop supporting them, too.
As a side effect, this fixes an assertion failure that tb@ found
with afl(1), triggered by: .Bl -column -4n

Revision 1.261 / (download) - annotate - [select for diffs], Sun Feb 5 22:30:29 2017 UTC (3 years, 6 months ago) by schwarze
Branch: MAIN
Changes since 1.260: +5 -3 lines
Diff to previous 1.260 (colored)

document output spacing near delimiters

Revision 1.260 / (download) - annotate - [select for diffs], Mon Jan 9 14:10:53 2017 UTC (3 years, 6 months ago) by schwarze
Branch: MAIN
Changes since 1.259: +20 -8 lines
Diff to previous 1.259 (colored)

Clarify how tabs after .It work
because this is a really nasty trap for the unwary.

Triggered by a question from Abhinav Upadhyay <er dot abhinav dot
upadhyay at gmail dot com> (NetBSD) on discuss@.

Revision 1.259 / (download) - annotate - [select for diffs], Wed Dec 28 17:34:18 2016 UTC (3 years, 7 months ago) by schwarze
Branch: MAIN
Changes since 1.258: +5 -6 lines
Diff to previous 1.258 (colored)

Make the second, section number argument of .Xr mandatory.
In fact, we have been requiring it for many years.
The only reason to not warn when it was missing
was excessive traditionalism - it was optional in 4.4BSD.

Revision 1.258 / (download) - annotate - [select for diffs], Tue Oct 11 17:30:33 2016 UTC (3 years, 9 months ago) by schwarze
Branch: MAIN
Changes since 1.257: +8 -2 lines
Diff to previous 1.257 (colored)

link to http://mdocml.bsd.lv/mdoc/ below SEE ALSO;
tweak and OK jmc@

Revision 1.257 / (download) - annotate - [select for diffs], Thu Nov 5 12:06:45 2015 UTC (4 years, 9 months ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_13_4
Changes since 1.256: +7 -2 lines
Diff to previous 1.256 (colored)

specify option ordering in the DESCRIPTION section;
from guenther@, ok and tweaks jmc@

Revision 1.256 / (download) - annotate - [select for diffs], Sun Oct 11 18:56:51 2015 UTC (4 years, 9 months ago) by schwarze
Branch: MAIN
Changes since 1.255: +10 -6 lines
Diff to previous 1.255 (colored)

Mention that the first argument of .Pf does not need escaping.
While here, make the first sentence regarding .Pf more concise.
OK jmc@

Revision 1.255 / (download) - annotate - [select for diffs], Thu Sep 24 18:41:22 2015 UTC (4 years, 10 months ago) by schwarze
Branch: MAIN
Changes since 1.254: +3 -3 lines
Diff to previous 1.254 (colored)

typos; found and fixed by sobrado@

Revision 1.254 / (download) - annotate - [select for diffs], Mon Sep 14 20:10:19 2015 UTC (4 years, 10 months ago) by schwarze
Branch: MAIN
Changes since 1.253: +3 -3 lines
Diff to previous 1.253 (colored)

Avoid .Ns right after .Pf, it's pointless.

Revision 1.253 / (download) - annotate - [select for diffs], Fri Mar 13 20:20:07 2015 UTC (5 years, 4 months ago) by schwarze
Branch: MAIN
Changes since 1.252: +3 -3 lines
Diff to previous 1.252 (colored)

Remove the first comma from constructs like ", and," and ", or,":
You can use "and" and "or" to join sentence clauses,
and you can use commas, but both hinders reading;
patch from jmc@.

Revision 1.252 / (download) - annotate - [select for diffs], Mon Feb 23 13:31:04 2015 UTC (5 years, 5 months ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_13_3
Changes since 1.251: +5 -7 lines
Diff to previous 1.251 (colored)

improve NAME section diagnostics;
confusing messages reported by Jan Stary <hans at stare dot cz>

Revision 1.251 / (download) - annotate - [select for diffs], Sun Feb 15 17:57:45 2015 UTC (5 years, 5 months ago) by schwarze
Branch: MAIN
Changes since 1.250: +8 -7 lines
Diff to previous 1.250 (colored)

Tweak the wording to avoid the possible misunderstanding that .In
could only be used in the SYNOPSIS section.  It is fine anywhere.
Issue noticed by bentley@.

Revision 1.250 / (download) - annotate - [select for diffs], Thu Jan 29 00:33:57 2015 UTC (5 years, 6 months ago) by schwarze
Branch: MAIN
Changes since 1.249: +19 -102 lines
Diff to previous 1.249 (colored)

Radical cleanup of COMPATIBILITY sections:
Remove lots of lies, dozens of irrelevant implementation details,
and all references to groff versions older than 1.17.  Move relevant
information to the pages where it belongs, and out of mandoc(1) in
particular.  Add some missing general remarks to roff(7), where it
fits the character and purpose of the page much better.

Revision 1.249 / (download) - annotate - [select for diffs], Tue Jan 20 19:39:34 2015 UTC (5 years, 6 months ago) by schwarze
Branch: MAIN
Changes since 1.248: +5 -5 lines
Diff to previous 1.248 (colored)

change spelling of centre to center: consistent with other man pages
and the name of the syntax elements being described; from tedu@

Revision 1.248 / (download) - annotate - [select for diffs], Sat Jan 3 00:59:13 2015 UTC (5 years, 7 months ago) by schwarze
Branch: MAIN
Changes since 1.247: +17 -8 lines
Diff to previous 1.247 (colored)

Given the excessively technical description in the old mdoc_samples(7)
manual and its successor groff_mdoc(7), i always considered .Ql as
purely physical markup, but it turns out describing it better allows
to give it a semantic meaning (in-line literal display) that doesn't
contradict existing usage.  One less physical, one more semantic
macro, yay!

Found in a discussion with Steffen Nurpmeso <sdaoden at yandex dot com>.

Revision 1.247 / (download) - annotate - [select for diffs], Wed Dec 31 20:42:31 2014 UTC (5 years, 7 months ago) by schwarze
Branch: MAIN
Changes since 1.246: +7 -4 lines
Diff to previous 1.246 (colored)

describe .Ql more precisely;
defect pointed out by Steffen Nurpmeso <sdaoden at yandex dot com>

Revision 1.246 / (download) - annotate - [select for diffs], Sun Dec 28 15:23:33 2014 UTC (5 years, 7 months ago) by schwarze
Branch: MAIN
Changes since 1.245: +23 -27 lines
Diff to previous 1.245 (colored)

Improve documentation of the header/footer macros .Dt, .Os, .TH:
* State the defaults for .Os and the fourth .TH argument.
* Sync the section titles, and stop advertising obscure sections that
aren't actually fully supported and certainly not recommended for use.

Revision 1.245 / (download) - annotate - [select for diffs], Sun Nov 30 21:56:18 2014 UTC (5 years, 8 months ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_13_2
Changes since 1.244: +3 -13 lines
Diff to previous 1.244 (colored)

delete three standard abbreviations that are
* no longer used in OpenBSD
* not used in any of NetBSD, FreeBSD, or DragonFly
* not supported by groff

Revision 1.244 / (download) - annotate - [select for diffs], Fri Nov 28 18:36:35 2014 UTC (5 years, 8 months ago) by schwarze
Branch: MAIN
Changes since 1.243: +4 -34 lines
Diff to previous 1.243 (colored)

Retire support for CSRG supplementary document titles.  These are
long obsolete and were never written in mdoc(7) in the first place.
Removes 100 lines from source files.

Revision 1.243 / (download) - annotate - [select for diffs], Fri Nov 28 18:09:01 2014 UTC (5 years, 8 months ago) by schwarze
Branch: MAIN
Changes since 1.242: +3 -8 lines
Diff to previous 1.242 (colored)

Drop useless architecture table.  Validating architecture names
is a job for makewhatis(8)/mandoc.db(5), not for the parser.
Removes 150 lines from source files and 4k (1%) from the binary.
Bloat found by deraadt@.

Revision 1.242 / (download) - annotate - [select for diffs], Thu Nov 27 16:20:31 2014 UTC (5 years, 8 months ago) by schwarze
Branch: MAIN
Changes since 1.241: +8 -9 lines
Diff to previous 1.241 (colored)

Fix the obsolete .Db (toggle debug mode) macro to ignore its arguments
and not trigger an assertion when there is more than one argument;
the latter found by jsg@ with afl.

Revision 1.241 / (download) - annotate - [select for diffs], Sun Nov 16 20:46:21 2014 UTC (5 years, 8 months ago) by schwarze
Branch: MAIN
Changes since 1.240: +2 -21 lines
Diff to previous 1.240 (colored)

Delete five standards that are:
* not supported by groff
* not used in any OpenBSD, NetBSD, DragonFly or FreeBSD base manual
* superseded or retracted
* and more than ten years old
Triggered by a question from Carsten Kunze (Heirloom troff).
OK guenther@ jmc@

Revision 1.240 / (download) - annotate - [select for diffs], Thu Oct 30 20:10:02 2014 UTC (5 years, 9 months ago) by schwarze
Branch: MAIN
Changes since 1.239: +7 -4 lines
Diff to previous 1.239 (colored)

Major bugsquashing with respect to -offset and -width:
1. Support specifying the .Bd and .Bl -offset as a macro default width;
while here, simplify the code handling the same for .Bl -width.
2. Correct handling of .Bl -offset arguments:  unlike .Bd -offset, the
arguments "left", "indent", and "indent-two" have no special meaning.
3. Fix the scaling of string length -offset and -width arguments in -Thtml.
Triggered by an incomplete documentation patch from bentley@.

Revision 1.239 / (download) - annotate - [select for diffs], Mon Oct 20 17:59:20 2014 UTC (5 years, 9 months ago) by schwarze
Branch: MAIN
Changes since 1.238: +22 -10 lines
Diff to previous 1.238 (colored)

improve documentation of .Fa, .Va, and .Vt;
inspired by a discussion with matthew@

Revision 1.238 / (download) - annotate - [select for diffs], Mon Oct 13 12:46:28 2014 UTC (5 years, 9 months ago) by schwarze
Branch: MAIN
Changes since 1.237: +3 -3 lines
Diff to previous 1.237 (colored)

Clarify: SEE ALSO sections are sorted case insensitively.
Patch from bentley@, ok jmc@.

Revision 1.237 / (download) - annotate - [select for diffs], Wed Sep 17 00:43:15 2014 UTC (5 years, 10 months ago) by schwarze
Branch: MAIN
Changes since 1.236: +3 -3 lines
Diff to previous 1.236 (colored)

Five year old typo reported by Theo Buehler at math dot ethz dot ch, thanks.
I nearly asked: ``What's wrong with it? It formats as "intended".''
(However, what Kristaps intended to write was "indented".)

Revision 1.236 / (download) - annotate - [select for diffs], Thu Aug 28 03:51:56 2014 UTC (5 years, 11 months ago) by schwarze
Branch: MAIN
Changes since 1.235: +8 -4 lines
Diff to previous 1.235 (colored)

Support .St -susv1 and .St -susv4.  Illumos wants to use this,
and it's illogical anyway to have -susv2 and -susv3 but not -susv4.

Revision 1.235 / (download) - annotate - [select for diffs], Thu Aug 14 20:57:19 2014 UTC (5 years, 11 months ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_12_4, VERSION_1_12
Changes since 1.234: +40 -13 lines
Diff to previous 1.234 (colored)

Clarify that .Em and .Sy are physical, not semantic markup,
explain appropriate usage, and provide some examples.
ok jmc@

Revision 1.234 / (download) - annotate - [select for diffs], Fri Aug 8 16:38:06 2014 UTC (5 years, 11 months ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_13_1
Changes since 1.233: +10 -5 lines
Diff to previous 1.233 (colored)

When .Sm is called without an argument, groff toggles the spacing mode,
so let us do the same for compatibility.  Using this feature is of
course not recommended except in manual page obfuscation contests.

Revision 1.233 / (download) - annotate - [select for diffs], Fri Aug 8 01:52:40 2014 UTC (6 years ago) by schwarze
Branch: MAIN
Changes since 1.232: +18 -20 lines
Diff to previous 1.232 (colored)

some corrections and improvements with respect to prologue macros;
found while working on mandoc(1) messages

Revision 1.232 / (download) - annotate - [select for diffs], Sun Jul 13 10:24:40 2014 UTC (6 years ago) by schwarze
Branch: MAIN
Changes since 1.231: +21 -9 lines
Diff to previous 1.231 (colored)

Unconfuse .Fa documentation:
You can use .Fa with just a type, without a name,
but when you give both, which is the usual case,
they need to go into one single .Fa argument.
Observed by bentley@; ok jmc@ bentley@.

Revision 1.231 / (download) - annotate - [select for diffs], Wed Jul 2 03:48:07 2014 UTC (6 years, 1 month ago) by schwarze
Branch: MAIN
Changes since 1.230: +31 -18 lines
Diff to previous 1.230 (colored)

Implement the obsolete macros .En .Es .Fr .Ot for backward compatibility,
since this is hardly more complicated than explicitly ignoring them
as we did in the past.  Of course, do not use them!

Revision 1.230 / (download) - annotate - [select for diffs], Tue Jun 24 21:43:08 2014 UTC (6 years, 1 month ago) by schwarze
Branch: MAIN
Changes since 1.229: +24 -48 lines
Diff to previous 1.229 (colored)

Deprecate .Tn and .Ux, and make it clearer that .Bt and .Ud are deprecated.
Do not use these macros in new documents, they provide no value.
Instead, usually no macro and no markup is needed at all.
Of course, they remain supported for compatibility with existing manuals.

Jason McIntyre (OpenBSD), Thomas Klausner (NetBSD) and
Franco Fichtner (DragonFly) are OK with this documentation change.

Revision 1.229 / (download) - annotate - [select for diffs], Sun Jun 22 17:07:06 2014 UTC (6 years, 1 month ago) by schwarze
Branch: MAIN
Changes since 1.228: +7 -36 lines
Diff to previous 1.228 (colored)

Minimal COMPATIBILITY cleanup:
* Mention that the list is incomplete.
* I implemented %C for groff -current, and it was accepted.
* Font family is \F, not \f.
* Escapes and scaling widths are documented in roff(7), not here.
* Quoting quotes by doubling them is now supported.

Revision 1.228 / (download) - annotate - [select for diffs], Mon Mar 31 01:05:32 2014 UTC (6 years, 4 months ago) by schwarze
Branch: MAIN
Changes since 1.227: +7 -2 lines
Diff to previous 1.227 (colored)

Support the CONTEXT section for kernel manual pages found in Solaris and
OpenBSD manuals.  It describes which contexts you can call functions in.
from dlg@, ok jmc@ deraadt@

Revision 1.227 / (download) - annotate - [select for diffs], Sun Feb 16 14:26:55 2014 UTC (6 years, 5 months ago) by schwarze
Branch: MAIN
Changes since 1.226: +17 -11 lines
Diff to previous 1.226 (colored)

After Werner Lemberg accepted and committed some updates to the manual
page template contained in groff_mdoc(7), catch up with our own stuff.
In particular, allow ERRORS in section 4 and DIAGNOSTICS in section 9.
ok jmc@

Revision 1.226 / (download) - annotate - [select for diffs], Fri Jan 24 22:54:33 2014 UTC (6 years, 6 months ago) by schwarze
Branch: MAIN
Changes since 1.225: +202 -74 lines
Diff to previous 1.225 (colored)

Supplement the documentation of the .St macro by minimal commentary
regarding the content and relationships of the various standards,
and sort and group them.
tweaks and ok guenther@, ok millert@ sobrado@ jmc@

Revision 1.225 / (download) - annotate - [select for diffs], Mon Jan 20 00:51:43 2014 UTC (6 years, 6 months ago) by schwarze
Branch: MAIN
Changes since 1.224: +33 -33 lines
Diff to previous 1.224 (colored)

Change markup of some fixed strings from .Ar to .Cm.

Revision 1.224 / (download) - annotate - [select for diffs], Tue Dec 31 23:29:41 2013 UTC (6 years, 7 months ago) by schwarze
Branch: MAIN
Changes since 1.223: +4 -2 lines
Diff to previous 1.223 (colored)

Support .St -p1003.1-2013, "IEEE Std 1003.1-2008/Cor 1-2013".

Note that the POSIX-2008 standard remains in force, so please refrain
from wholesale 2008 -> 2013 replacements.  Make sure to only use the
new -p1003.1-2013 argument for cases where "IEEE Std 1003.1(TM)-2008/
Cor 1-2013, IEEE Standard for Information Technology--Portable
Operating System Interface (POSIX(R)), Technical Corrigendum 1"
actually changes something in the standard with respect to the
specific function documented in the manual you touch.  Otherwise,
please continue using .St -p1003.1-2008.

Triggered by a similar, but slightly incorrect patch from jmc@;
ok guenther@.

Revision 1.223 / (download) - annotate - [select for diffs], Wed Dec 25 14:09:32 2013 UTC (6 years, 7 months ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_12_3
Changes since 1.222: +5 -3 lines
Diff to previous 1.222 (colored)

Support .St -xsh4.2, the System Interfaces part of the original Single
UNIX Specification.  As this one appears to be used in the wild and we
already have -xpg4.2 and even -xsh5, it makes sense to add this one.
Note that calling the original SUS XPG4.2 appears to be more common
than calling it SUSv1, so it's ok that we don't have .St -susv1.
From Sascha Wildner <saw at online dot de> (DragonFly) via Franco Fichtner.

Revision 1.222 / (download) - annotate - [select for diffs], Sat Nov 2 20:39:49 2013 UTC (6 years, 9 months ago) by schwarze
Branch: MAIN
Changes since 1.221: +30 -9 lines
Diff to previous 1.221 (colored)

While answering a question asked by espie@, i noticed that .Fd is not
completely obsolete, but still somewhat useful for listing preprocessor
directives, in particular in the SYNOPSIS.

Revision 1.221 / (download) - annotate - [select for diffs], Sun Oct 6 17:01:52 2013 UTC (6 years, 10 months ago) by schwarze
Branch: MAIN
Changes since 1.220: +3 -3 lines
Diff to previous 1.220 (colored)

The .Lb arguments wants a "lib" prefix;
from Sascha Wildner via Franco Fichtner (DragonFly);
also fixing the same in the mdoc(7) example while i'm about it.

Revision 1.220 / (download) - annotate - [select for diffs], Wed Aug 14 15:08:31 2013 UTC (6 years, 11 months ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_12_2
Changes since 1.219: +17 -7 lines
Diff to previous 1.219 (colored)

Use text production macros to document themselves.
Part of the patch was sent in by Jan Stary <hans at stare dot cz>,
another part was added by jmc@, the rest was added by myself;
ok jmc@.

Revision 1.219 / (download) - annotate - [select for diffs], Sat Jul 13 19:41:16 2013 UTC (7 years ago) by schwarze
Branch: MAIN
Changes since 1.218: +5 -5 lines
Diff to previous 1.218 (colored)

For citing the names and email addresses of authors,
consistently use the style ".An name Aq Mt email".

Triggered by a question from Jan Stary <hans at stare dot cz>,
ok jmc@.

Revision 1.218 / (download) - annotate - [select for diffs], Wed Jun 19 21:20:27 2013 UTC (7 years, 1 month ago) by schwarze
Branch: MAIN
Changes since 1.217: +12 -6 lines
Diff to previous 1.217 (colored)

Add .St values for POSIX 1003.1d, 1003.1j, and 1003.1q.
Tweak descriptions of the other POSIX 1003.1<letter> standards.
Sort a few others into their proper places.

From Philip Guenther@ during t2k13.

Revision 1.217 / (download) - annotate - [select for diffs], Sun Apr 28 07:54:01 2013 UTC (7 years, 3 months ago) by schwarze
Branch: MAIN
Changes since 1.216: +4 -4 lines
Diff to previous 1.216 (colored)

- (mdoc.7) fix Xr to self
- double word fix
from jmc@

Revision 1.216 / (download) - annotate - [select for diffs], Wed Aug 29 23:38:50 2012 UTC (7 years, 11 months ago) by schwarze
Branch: MAIN
Changes since 1.215: +6 -12 lines
Diff to previous 1.215 (colored)

1) Remove documentation of the groff-1.15 compatibility quirk
of suppressing spacing before a third .Xr argument
because that quirk was removed in mdoc_macro.c rev. 1.113.

2) Mark the "section" argument to .Xr as (syntactically) optional,
but still do not encourage omitting it.
The missing .Op was reported by espie@.

Wording tweaked by and ok jmc@, ok millert@.

Revision 1.215 / (download) - annotate - [select for diffs], Wed Jun 20 22:06:30 2012 UTC (8 years, 1 month ago) by schwarze
Branch: MAIN
Changes since 1.214: +11 -11 lines
Diff to previous 1.214 (colored)

When i moved some low-level stuff from mdoc(7) and man(7)
to roff(7) some time ago, i forgot to adjust the cross-references.
Reported by Tim van der Molen <tbvdm at xs4all dot nl>, thanks.

ok jmc@

Revision 1.214 / (download) - annotate - [select for diffs], Tue Jan 3 10:18:05 2012 UTC (8 years, 7 months ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_12_1
Changes since 1.213: +4 -2 lines
Diff to previous 1.213 (colored)

Accommodate for ISO C11.  groff applied the same `St' argument on
03/01/2012.  From a tweaked patch (isoC-11 -> isoC-2011) by Ulrich
Sporlein: thanks!

Revision 1.213 / (download) - annotate - [select for diffs], Tue Nov 1 14:59:27 2011 UTC (8 years, 9 months ago) by schwarze
Branch: MAIN
Changes since 1.212: +16 -38 lines
Diff to previous 1.212 (colored)

Clean up the description of .Dt:
- Volume and arch are both optional and not alternatives.
- Zap verbiage about what's obvious from the synopsis.
- For fixed argument strings, use .Cm, not .Ar.
Using lots of input from jmc@.

Also, state that the list of valid architectures varies by OS.
If a downstream distribution wants to provide a specific list,
maintaining a local patch is the way to go.

Revision 1.212 / (download) - annotate - [select for diffs], Tue Sep 27 21:49:23 2011 UTC (8 years, 10 months ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_12_0
Changes since 1.211: +3 -3 lines
Diff to previous 1.211 (colored)

even though .Bl is not callable, groff complains when it appears
unescaped on a macro line, so lets just escape it;
noticed by jmc@

Revision 1.211 / (download) - annotate - [select for diffs], Mon Sep 26 23:07:31 2011 UTC (8 years, 10 months ago) by schwarze
Branch: MAIN
Changes since 1.210: +762 -962 lines
Diff to previous 1.210 (colored)

Reorganize part of the content:

1) Move the LANGUAGE SYNTAX from mdoc(7) and man(7) to roff(7),
it's common to both and it's actually roff syntax.
2) Move the MACRO SYNTAX down to the bottom, such that the less
technical parts MANUAL STRUCTURE and MACRO OVERVIEW get to the top.

Getting everything to again fit together after the reshuffling
required various adjustments; also adjust and improve
the DESCRIPTIONS while there.

feedback and "go ahead"  jmc@ kristaps@

Revision 1.210 / (download) - annotate - [select for diffs], Sun Sep 18 07:57:16 2011 UTC (8 years, 10 months ago) by schwarze
Branch: MAIN
Changes since 1.209: +126 -2 lines
Diff to previous 1.209 (colored)

Add a MACRO OVERVIEW, listing all macros ordered by purpose,
each with a one-line discription.  Use this when wondering
which macro fits best for your particular use case, and whether
there are alternatives.
feedback ond ok jmc@, ok kristaps@

Revision 1.209 / (download) - annotate - [select for diffs], Fri Sep 16 20:44:57 2011 UTC (8 years, 10 months ago) by schwarze
Branch: MAIN
Changes since 1.208: +4 -2 lines
Diff to previous 1.208 (colored)

support ".St -iso8601"; committing on behalf of jmc@

Revision 1.208 / (download) - annotate - [select for diffs], Fri Sep 2 19:37:35 2011 UTC (8 years, 11 months ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_11_7
Changes since 1.207: +4 -4 lines
Diff to previous 1.207 (colored)

Fix typos and spelling errors found by demandoc -w | spell -b.

Revision 1.207 / (download) - annotate - [select for diffs], Tue Aug 30 13:14:01 2011 UTC (8 years, 11 months ago) by kristaps
Branch: MAIN
Changes since 1.206: +4 -4 lines
Diff to previous 1.206 (colored)

Order -column lists to have the arguments follow `-column'.  From a
patch by Jason McIntyre.

Revision 1.206 / (download) - annotate - [select for diffs], Tue Aug 30 12:16:36 2011 UTC (8 years, 11 months ago) by kristaps
Branch: MAIN
Changes since 1.205: +7 -13 lines
Diff to previous 1.205 (colored)

Remove unnecessary `Pp'/`-compat' combination for column lists.
Directly from a patch by Jason McIntyre.

Revision 1.205 / (download) - annotate - [select for diffs], Fri Aug 19 13:07:22 2011 UTC (8 years, 11 months ago) by kristaps
Branch: MAIN
Changes since 1.204: +3 -3 lines
Diff to previous 1.204 (colored)

Bring man.7's LANGUAGE SYNTAX in line with mdoc.7.  While here, change
out the \*q escapes.  Also fix some spelling typos in both manuals.

Revision 1.204 / (download) - annotate - [select for diffs], Fri Aug 19 12:55:33 2011 UTC (8 years, 11 months ago) by kristaps
Branch: MAIN
Changes since 1.203: +21 -15 lines
Diff to previous 1.203 (colored)

Make LANGUAGE SYNTAX examples a bit more explanatory.

Revision 1.203 / (download) - annotate - [select for diffs], Fri Aug 19 10:19:55 2011 UTC (8 years, 11 months ago) by kristaps
Branch: MAIN
Changes since 1.202: +67 -74 lines
Diff to previous 1.202 (colored)

First, use \(dq instead of \*q for double-quote.  Second, use `Li' to
note literal text in "Examples:" parts.  Finally, move parts of
Quotation related to keeping whitespace into Whitespace and clean up the
text to be a bit clearer.  Examples can be added back in at will, but
now it follows the general layout of explanation followed by examples.

Revision 1.202 / (download) - annotate - [select for diffs], Thu Aug 18 08:58:44 2011 UTC (8 years, 11 months ago) by kristaps
Branch: MAIN
Changes since 1.201: +3 -2 lines
Diff to previous 1.201 (colored)

Replace the old `An'/`Aq' AUTHORS note with `An'/`Mt'.

Revision 1.201 / (download) - annotate - [select for diffs], Wed Aug 17 22:20:14 2011 UTC (8 years, 11 months ago) by kristaps
Branch: MAIN
Changes since 1.200: +12 -4 lines
Diff to previous 1.200 (colored)

Add example of comments in man.7 and mdoc.7.

Revision 1.200 / (download) - annotate - [select for diffs], Wed Aug 17 20:34:53 2011 UTC (8 years, 11 months ago) by kristaps
Branch: MAIN
Changes since 1.199: +92 -60 lines
Diff to previous 1.199 (colored)

Clean up and normalise the LANGUAGE SYNTAX section in mdoc.7:

 - make examples trail each section
 - make explanations more concise
 - remove references to troff

ok Jason McIntyre.

Revision 1.199 / (download) - annotate - [select for diffs], Tue Aug 16 23:44:58 2011 UTC (8 years, 11 months ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_11_6
Changes since 1.198: +7 -7 lines
Diff to previous 1.198 (colored)

Replace the .Fl examples by others exhibiting the same features,
but avoiding use of .Nm, because letting .Nm call other macros
is unusual style, and we don't want unusual style in examples.
Issue brought up by kristaps@.

Revision 1.198 / (download) - annotate - [select for diffs], Tue Aug 16 23:37:39 2011 UTC (8 years, 11 months ago) by schwarze
Branch: MAIN
Changes since 1.197: +167 -53 lines
Diff to previous 1.197 (colored)

More information about lots of macros, many new examples, and various fixes.
ok kristaps@

Revision 1.197 / (download) - annotate - [select for diffs], Wed Aug 10 14:07:23 2011 UTC (8 years, 11 months ago) by kristaps
Branch: MAIN
Changes since 1.196: +13 -7 lines
Diff to previous 1.196 (colored)

Allow `Sx' and `Ss' to have child nodes.  Fixes manuals in NetBSD.
Originally pointed out by joerg@ then again by Thomas Klausner by way of
Nicolas Joy.  Note: don't use these constructions as you can't link to
the sections with `Sx'.

Revision 1.196 / (download) - annotate - [select for diffs], Wed Aug 3 21:25:23 2011 UTC (9 years ago) by schwarze
Branch: MAIN
Changes since 1.195: +65 -28 lines
Diff to previous 1.195 (colored)

Add small chunks of new text and better examples written from scratch,
filling gaps found by checking the MANUAL DOMAIN chapter in mdoc.samples(7).
While here, fix lots of minor issues.
feedback and ok jmc@

Revision 1.195 / (download) - annotate - [select for diffs], Tue Aug 2 01:07:26 2011 UTC (9 years ago) by schwarze
Branch: MAIN
Changes since 1.194: +92 -46 lines
Diff to previous 1.194 (colored)

The term "reserved terms" is too broad, so narrow it down
to "delimiters", and explain which special handling they get
as macro arguments.  Move the text to a better place and remove
a few lies.  Postpone figuring out the lists of macros causing
that special handling, it would cost too much time right now.
feedback and ok jmc@

This also brings the file back in sync with OpenBSD.

Revision 1.194 / (download) - annotate - [select for diffs], Mon Aug 1 07:45:11 2011 UTC (9 years ago) by schwarze
Branch: MAIN
Changes since 1.193: +39 -5 lines
Diff to previous 1.193 (colored)

Add some new text written from scratch after checking whether anything
explained in mdoc.samples(7) is missing from mdoc(7):
* Discourage trailing whitespace.
* Move all information about quoted arguments to the relevant
  subsection, shortening it a bit, and adding an example.
* Mention that blanks can be quoted with a backslash.
* A better .Nd line in the template (verbatim from mdoc.samples(7)).
* Explain how to escape callable macro names, and provide examples.
ok jmc@

Revision 1.193 / (download) - annotate - [select for diffs], Sun Jul 31 17:42:50 2011 UTC (9 years ago) by schwarze
Branch: MAIN
Changes since 1.192: +9 -9 lines
Diff to previous 1.192 (colored)

trivial fixes found while merging to OpenBSD:
* ellipsis is an argument to .Ar, not part of the preceding argument
* libz, libpam, on, off are not placeholders for arguments
* .Rv is not only relevant for system calls, see atexit(3), sem_init(3)

Revision 1.192 / (download) - annotate - [select for diffs], Sun Jul 31 17:30:33 2011 UTC (9 years ago) by schwarze
Branch: MAIN
Changes since 1.191: +5 -2 lines
Diff to previous 1.191 (colored)

System III is relevant for string(3) HISTORY.

Revision 1.191 / (download) - annotate - [select for diffs], Mon Jul 18 10:23:02 2011 UTC (9 years ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_11_5
Changes since 1.190: +22 -12 lines
Diff to previous 1.190 (colored)

Clarify up `Rv' and `Ex' documentation.

Revision 1.190 / (download) - annotate - [select for diffs], Fri Jul 15 20:40:32 2011 UTC (9 years ago) by schwarze
Branch: MAIN
Changes since 1.189: +43 -25 lines
Diff to previous 1.189 (colored)

improve documentation of .Bl -column .It Ta
using feedback from kristaps@, ok jmc@

Revision 1.189 / (download) - annotate - [select for diffs], Mon Jul 11 08:45:02 2011 UTC (9 years ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_11_4
Changes since 1.188: +20 -6 lines
Diff to previous 1.188 (colored)

Be more specific about `Dv', `Er', and `Ev'.

Revision 1.188 / (download) - annotate - [select for diffs], Thu May 26 09:26:16 2011 UTC (9 years, 2 months ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_11_3
Changes since 1.187: +7 -6 lines
Diff to previous 1.187 (colored)

Noticed that our skeleton mdoc.7 had lower-case `Dt'.  Fixed and added
some language for clarity.

Revision 1.187 / (download) - annotate - [select for diffs], Sat May 21 15:55:42 2011 UTC (9 years, 2 months ago) by schwarze
Branch: MAIN
Changes since 1.186: +2 -4 lines
Diff to previous 1.186 (colored)

remove a sentence which isn;t true;
from jmc@

Revision 1.186 / (download) - annotate - [select for diffs], Sun Apr 17 11:57:07 2011 UTC (9 years, 3 months ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_11_2
Changes since 1.185: +5 -4 lines
Diff to previous 1.185 (colored)

The semantics of .Bk was described incorrectly
for the case of multiple sibling macros on a single input line.
Issue found investigating a question from sobrado@.
"I like this diff" kristaps@

Revision 1.185 / (download) - annotate - [select for diffs], Wed Apr 6 11:39:25 2011 UTC (9 years, 4 months ago) by kristaps
Branch: MAIN
Changes since 1.184: +83 -62 lines
Diff to previous 1.184 (colored)

First, properly escape periods with \&.  Then consistently refer to
non-macro lines as "text lines" (after defining them as such).  Clean up
notion of font scope.  Note comma usage in multiple `Nm's.  Note
ordering of SYNOPSIS section stuff.  Add some bits about DESCRIPTION
syntax (brief description, then args).  Note that `Bl' can also contain
HEAD.  Finally, fix some `Cm' entries to be properly `Ar'.

Ok Jason McIntyre.

Revision 1.184 / (download) - annotate - [select for diffs], Fri Apr 1 19:50:49 2011 UTC (9 years, 4 months ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_11_1
Changes since 1.183: +3 -3 lines
Diff to previous 1.183 (colored)

In reality `In' only accepts one argument.  Subsequent ones are not
included in the brackets.  We really should have a warning about this,
but that'll wait for another day.

Revision 1.183 / (download) - annotate - [select for diffs], Fri Apr 1 19:47:33 2011 UTC (9 years, 4 months ago) by kristaps
Branch: MAIN
Changes since 1.182: +5 -5 lines
Diff to previous 1.182 (colored)

Properly quote arguments in `Fn' documentation.  Also make standalone
'...' have a properly-escaped initial dot.

Revision 1.182 / (download) - annotate - [select for diffs], Thu Mar 17 14:50:14 2011 UTC (9 years, 4 months ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_10_10
Changes since 1.181: +14 -11 lines
Diff to previous 1.181 (colored)

"Reserved Characters" isn't correct since `\.' and `\*(Ba' aren't
characters.  Use "Reserved Terms" instead.

Revision 1.181 / (download) - annotate - [select for diffs], Mon Mar 7 01:35:51 2011 UTC (9 years, 5 months ago) by schwarze
Branch: MAIN
Changes since 1.180: +39 -43 lines
Diff to previous 1.180 (colored)

Clean up date handling,
as a first step to get rid of the frequent petty warnings in this area:
 - always store dates as strings, not as seconds since the Epoch
 - for input, try the three most common formats everywhere
 - for unrecognized format, just pass the date though verbatim
 - when there is no date at all, still use the current date
Originally triggered by a one-line patch from Tim van der Molen,
<tbvdm at xs4all dot nl>, which is included here.
Feedback and OK on manual parts from jmc@.
"please check this in" kristaps@

Revision 1.180 / (download) - annotate - [select for diffs], Wed Feb 9 10:03:02 2011 UTC (9 years, 5 months ago) by kristaps
Branch: MAIN
Changes since 1.179: +3 -2 lines
Diff to previous 1.179 (colored)

Add stub for eqn.7 manual and flip it on.  Also note COMPATIBILITY issue
of how we considered .TS (etc.) macros and how the preprocessors do.

Revision 1.179 / (download) - annotate - [select for diffs], Mon Feb 7 00:05:40 2011 UTC (9 years, 6 months ago) by schwarze
Branch: MAIN
Changes since 1.178: +8 -6 lines
Diff to previous 1.178 (colored)

The macro .Ns has no effect at the beginning of an input line;
ok kristaps@ jmc@.

Revision 1.178 / (download) - annotate - [select for diffs], Wed Feb 2 21:40:45 2011 UTC (9 years, 6 months ago) by kristaps
Branch: MAIN
Changes since 1.177: +4 -2 lines
Diff to previous 1.177 (colored)

If `Ns' is specified on its own line, it should be ignored.  This is
shitty groff behaviour.  Do the same, but raise a warning to this
effect.  This from a TODO noted by schwarze@.

Revision 1.177 / (download) - annotate - [select for diffs], Tue Jan 25 00:40:14 2011 UTC (9 years, 6 months ago) by schwarze
Branch: MAIN
Changes since 1.176: +2 -5 lines
Diff to previous 1.176 (colored)

As noticed by deraadt@, it goes without saying that text files
on a UNIX system use UNIX conventions, and UNIX tools working
on them expect that.
ok jmc@

Revision 1.176 / (download) - annotate - [select for diffs], Sat Jan 22 14:05:33 2011 UTC (9 years, 6 months ago) by schwarze
Branch: MAIN
Changes since 1.175: +11 -11 lines
Diff to previous 1.175 (colored)

Lots of in-line macros require arguments but were not marked as such.
Check prompted by kristaps@.

Revision 1.175 / (download) - annotate - [select for diffs], Wed Jan 12 10:43:22 2011 UTC (9 years, 6 months ago) by kristaps
Branch: MAIN
Changes since 1.174: +5 -2 lines
Diff to previous 1.174 (colored)

If the first character of free-form text is whitespace, then a newline
shall precede outputted text (surprise!).

Revision 1.174 / (download) - annotate - [select for diffs], Tue Jan 4 23:32:21 2011 UTC (9 years, 7 months ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_10_9
Changes since 1.173: +5 -2 lines
Diff to previous 1.173 (colored)

Moved table stuff from roff.7 into the new tbl.7 (suggested by Jason McIntyre).

Added cross-links to tbl.7 from other manuals.

Revision 1.173 / (download) - annotate - [select for diffs], Wed Dec 29 16:16:50 2010 UTC (9 years, 7 months ago) by kristaps
Branch: MAIN
Changes since 1.172: +94 -94 lines
Diff to previous 1.172 (colored)

In mdoc.7, don't use `D1' in place of `Dl' for code examples.

Revision 1.172 / (download) - annotate - [select for diffs], Mon Dec 27 20:39:46 2010 UTC (9 years, 7 months ago) by kristaps
Branch: MAIN
Changes since 1.171: +7 -2 lines
Diff to previous 1.171 (colored)

Note `Sx's connection to `Sh' and `Ss'.

Revision 1.171 / (download) - annotate - [select for diffs], Wed Dec 22 23:53:55 2010 UTC (9 years, 7 months ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_10_8
Changes since 1.170: +9 -7 lines
Diff to previous 1.170 (colored)

minor tweaks:
1. improve .Bl wording (from jmc@)
2. jmc@ noted that the .Mt default (the same as in groff) makes no sense,
and there is no better default we could use; thus, regard it as
implementation dependent and do not document it
3. fix formatting of one COMPATIBILITY note: move "and" out of .Sx
ok kristaps@, jmc@

Revision 1.170 / (download) - annotate - [select for diffs], Sat Dec 18 19:12:00 2010 UTC (9 years, 7 months ago) by schwarze
Branch: MAIN
Changes since 1.169: +9 -5 lines
Diff to previous 1.169 (colored)

Sync to OpenBSD: More precise description of .Xo, and don't talk
about deprecation, because there are cases were choosing .Xo or
backslash line continuation is merely a matter of taste, not a
difference in readability, and well-used .Xo is even slightly
more portable.
OK jmc@

Revision 1.169 / (download) - annotate - [select for diffs], Mon Dec 6 16:37:32 2010 UTC (9 years, 8 months ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_10_7
Changes since 1.168: +6 -11 lines
Diff to previous 1.168 (colored)

Import changes by schwarze@ and Jason McIntyre into manuals.  These are
for the new libroff macros, the new libman macros, and for the sake of
general clarity.

Note that `ft' documentation is NOT included, as I've kept it in -man:
it's highly confusing to have it in roff.7 when it's not implemented for
both -man and -mdoc, as at least in theory, roff.7 should include only
macros recognised by BOTH formats.

Revision 1.168 / (download) - annotate - [select for diffs], Sun Dec 5 15:37:30 2010 UTC (9 years, 8 months ago) by kristaps
Branch: MAIN
Changes since 1.167: +6 -1 lines
Diff to previous 1.167 (colored)

Merge schwarze@'s changes allowing nested displays.  Tweak the patch by
making sure output doesn't add a superfluous newline with the nested displays.
Also add a COMPATIBILITY note.

Rename a macro (DATESIZ) to be in line with OpenBSD (DATESIZE).

Revision 1.167 / (download) - annotate - [select for diffs], Tue Nov 30 21:44:59 2010 UTC (9 years, 8 months ago) by schwarze
Branch: MAIN
Changes since 1.166: +2 -2 lines
Diff to previous 1.166 (colored)

Restore the Id tag that i clobbered in my previous commit,
as pointed out by kristaps@.  Sorry!

Revision 1.166 / (download) - annotate - [select for diffs], Tue Nov 30 20:45:55 2010 UTC (9 years, 8 months ago) by schwarze
Branch: MAIN
Changes since 1.165: +25 -15 lines
Diff to previous 1.165 (colored)

Merge OpenBSD mdoc.7 rev. 1.56 and 1.57:
Define the terms "callable" and "parsed" with more precision.
Be more specific about what .Xo can be used for.
Be more specific about what "historic groff" refers to.
Explicitely mention the nine argument limit below COMPATIBILITY.
feedback and ok jmc@

Revision 1.165 / (download) - annotate - [select for diffs], Mon Nov 29 16:06:46 2010 UTC (9 years, 8 months ago) by kristaps
Branch: MAIN
Changes since 1.164: +5 -2 lines
Diff to previous 1.164 (colored)

Migrate `Nm' and `Pa' handling from mdoc_action.c into mdoc_validate.c.

Document that `Pa' is replaced by a tilde, just like `Mt'.

Revision 1.164 / (download) - annotate - [select for diffs], Mon Nov 29 13:02:47 2010 UTC (9 years, 8 months ago) by kristaps
Branch: MAIN
Changes since 1.163: +5 -2 lines
Diff to previous 1.163 (colored)

Move `Mt', `Ar', and `Li' handling from mdoc_action.c into mdoc_validate.c.

Clarify that `Mt' gets a default `~' (as per groff 1.20) and document it
in mdoc.7.

Made `Lk' be removed in mdoc_macro.c if it has no arguments.  This fixes
segfaults in mdoc_{term,html}.c that nobody's managed to raise yet.

Revision 1.163 / (download) - annotate - [select for diffs], Fri Oct 29 10:38:54 2010 UTC (9 years, 9 months ago) by schwarze
Branch: MAIN
Changes since 1.162: +4 -4 lines
Diff to previous 1.162 (colored)

Referring to terms explained in other manuals, always use .Xr.
Otherwise, hyperlinks can't be produced and people will likely
miss the additional information available.
Suggested by deraadt@.

Revision 1.162 / (download) - annotate - [select for diffs], Sun Oct 24 14:49:35 2010 UTC (9 years, 9 months ago) by schwarze
Branch: MAIN
Changes since 1.161: +4 -1 lines
Diff to previous 1.161 (colored)

When mentioning a function documented elsewhere, .Xr is often better than .Fn.
Prodded by guenther@, ok jmc@.

Revision 1.161 / (download) - annotate - [select for diffs], Mon Sep 27 11:21:39 2010 UTC (9 years, 10 months ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_10_6
Changes since 1.160: +4 -3 lines
Diff to previous 1.160 (colored)

Suppress whitespace following Pp, Lp, sp, and the other newline-emitting
macros within an unfilled or literal `Bd'.

Revision 1.160 / (download) - annotate - [select for diffs], Mon Sep 27 06:56:44 2010 UTC (9 years, 10 months ago) by kristaps
Branch: MAIN
Changes since 1.159: +3 -2 lines
Diff to previous 1.159 (colored)

Added MIPS64.  From a patch by Jason McIntyre.

Revision 1.159 / (download) - annotate - [select for diffs], Sun Sep 26 19:46:48 2010 UTC (9 years, 10 months ago) by schwarze
Branch: MAIN
Changes since 1.158: +5 -3 lines
Diff to previous 1.158 (colored)

sync to OpenBSD:
note that IMPLEMENTATION NOTES is not used in OpenBSD
add missing comma in "sections 1, 6, & 8 only" below EXIT STATUS
below SEE ALSO, add an .Xr to man(1), and from man(7) to mdoc(7)

Revision 1.158 / (download) - annotate - [select for diffs], Sat Sep 4 17:22:41 2010 UTC (9 years, 11 months ago) by kristaps
Branch: MAIN
Changes since 1.157: +3 -3 lines
Diff to previous 1.157 (colored)

Clarified EXIT STATUS sections.  Discussed among schwarze@, Thomas, and
Jason.  Patch by Jason.

Revision 1.157 / (download) - annotate - [select for diffs], Sun Aug 29 11:28:09 2010 UTC (9 years, 11 months ago) by kristaps
Branch: MAIN
Changes since 1.156: +4 -2 lines
Diff to previous 1.156 (colored)

Remove overstrike `\o'.  This isn't the best solution because we really
should be printing the contents, but for the time being, this is good
enough.

Revision 1.156 / (download) - annotate - [select for diffs], Sat Aug 28 22:08:38 2010 UTC (9 years, 11 months ago) by kristaps
Branch: MAIN
Changes since 1.155: +9 -7 lines
Diff to previous 1.155 (colored)

Move mdoc/man template "The next is for" into the section itself.  Added
OpenBSD compatibility notes.  Based on a patch by Jason McIntyre.

Revision 1.155 / (download) - annotate - [select for diffs], Tue Aug 24 14:03:46 2010 UTC (9 years, 11 months ago) by kristaps
Branch: MAIN
Changes since 1.154: +2 -2 lines
Diff to previous 1.154 (colored)

Fixed HISTORY to note mdoc's rewrite in groff-1.17, not groff-1.20.

Revision 1.154 / (download) - annotate - [select for diffs], Tue Aug 24 13:39:37 2010 UTC (9 years, 11 months ago) by kristaps
Branch: MAIN
Changes since 1.153: +3 -1 lines
Diff to previous 1.153 (colored)

Strip out `\k' escape.

Revision 1.153 / (download) - annotate - [select for diffs], Tue Aug 24 13:07:01 2010 UTC (9 years, 11 months ago) by kristaps
Branch: MAIN
Changes since 1.152: +5 -4 lines
Diff to previous 1.152 (colored)

Stripping out of `\w' groff escape.  Yet another for pod2man...

Revision 1.152 / (download) - annotate - [select for diffs], Tue Aug 24 12:18:49 2010 UTC (9 years, 11 months ago) by kristaps
Branch: MAIN
Changes since 1.151: +3 -1 lines
Diff to previous 1.151 (colored)

Strip out the `\z' escape.  This is the first recursive sequence,
getting mandoc ready to handle pod2man's complex escapes.

Revision 1.151 / (download) - annotate - [select for diffs], Sun Aug 22 15:49:28 2010 UTC (9 years, 11 months ago) by kristaps
Branch: MAIN
Changes since 1.150: +13 -2 lines
Diff to previous 1.150 (colored)

Add a short HISTORY section to mdoc.7.  Facts provided by schwarze@'s
detective-work in the UNIX archives.

Revision 1.150 / (download) - annotate - [select for diffs], Sun Aug 22 14:54:29 2010 UTC (9 years, 11 months ago) by kristaps
Branch: MAIN
Changes since 1.149: +105 -112 lines
Diff to previous 1.149 (colored)

Sort COMPATIBILITY in mdoc(7) (from schwarze@).

Update escape COMPATIBILITY in mdoc(7) and man(7) (ok schwarze@).

Revision 1.149 / (download) - annotate - [select for diffs], Mon Aug 9 00:07:51 2010 UTC (10 years ago) by kristaps
Branch: MAIN
Changes since 1.148: +7 -3 lines
Diff to previous 1.148 (colored)

Correctly make quotes around `Lk' link-name argument.  Noted by Aldis
Berzoja.  Also note COMPATIBILITY of groff misformatting `Lk'.

Revision 1.148 / (download) - annotate - [select for diffs], Sat Aug 7 10:31:32 2010 UTC (10 years ago) by kristaps
Branch: MAIN
Changes since 1.147: +2 -2 lines
Diff to previous 1.147 (colored)

Removed cross-reference to groff(1) in favour of simply mentioning GNU
troff.  This removes the last groff(1) `Xr'.

Revision 1.147 / (download) - annotate - [select for diffs], Sat Aug 7 10:26:07 2010 UTC (10 years ago) by kristaps
Branch: MAIN
Changes since 1.146: +6 -6 lines
Diff to previous 1.146 (colored)

Added serial comma.

Put "remarks" for `%C' into COMPATIBILITY.

Revision 1.146 / (download) - annotate - [select for diffs], Sat Aug 7 10:18:36 2010 UTC (10 years ago) by kristaps
Branch: MAIN
Changes since 1.145: +3 -3 lines
Diff to previous 1.145 (colored)

`In' comes before `Vt' in function example of SYNOPSIS.

Revision 1.145 / (download) - annotate - [select for diffs], Sat Aug 7 09:56:12 2010 UTC (10 years ago) by kristaps
Branch: MAIN
Changes since 1.144: +2 -2 lines
Diff to previous 1.144 (colored)

Clarify that predefined strings aren't groff-isms, they're troff-isms.

Revision 1.144 / (download) - annotate - [select for diffs], Fri Aug 6 17:09:58 2010 UTC (10 years ago) by schwarze
Branch: MAIN
Changes since 1.143: +43 -38 lines
Diff to previous 1.143 (colored)

tweaks from jmc@:
* correct a few obvious mistakes
* adopt some of jmc@'s recent changes to man(7)
* cut down just a little on the awful tendency
  to stick a hyphen between two words.

Revision 1.143 / (download) - annotate - [select for diffs], Fri Aug 6 17:07:11 2010 UTC (10 years ago) by schwarze
Branch: MAIN
Changes since 1.142: +4 -6 lines
Diff to previous 1.142 (colored)

merge from OpenBSD:
- HISTORY is interesting even when there are STANDARDS
- more precise instructions what to put into AUTHORS
- add the version argument to the mdoc(7) .Os macro

Revision 1.142 / (download) - annotate - [select for diffs], Mon Jul 26 13:45:49 2010 UTC (10 years ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_10_5
Changes since 1.141: +11 -5 lines
Diff to previous 1.141 (colored)

Note that `Dd' can be empty.  This found following a thread on discuss@
started by Sascha Wildner, 07/25/2010 06:30 AM.

Revision 1.141 / (download) - annotate - [select for diffs], Mon Jul 26 12:51:56 2010 UTC (10 years ago) by kristaps
Branch: MAIN
Changes since 1.140: +231 -223 lines
Diff to previous 1.140 (colored)

Merge schwarze@'s pass over mdoc.7.  Fixed small new-sentence-new-line
nit noted by Jason McIntyre.

"your diff looks ok" (Jason McIntyre)

Revision 1.140 / (download) - annotate - [select for diffs], Mon Jul 19 21:59:48 2010 UTC (10 years ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_10_5_PREPDF
Changes since 1.139: +53 -15 lines
Diff to previous 1.139 (colored)

All macros in mdoc.7 are now documented.

Revision 1.139 / (download) - annotate - [select for diffs], Mon Jul 19 15:43:10 2010 UTC (10 years ago) by kristaps
Branch: MAIN
Changes since 1.138: +121 -7 lines
Diff to previous 1.138 (colored)

Finished document -mdoc macros.  Note `br' and `sp' remain.

Noted in arch.in and st.in that mdoc.7 must be updated if entries are
added.

Revision 1.138 / (download) - annotate - [select for diffs], Mon Jul 19 15:28:11 2010 UTC (10 years ago) by kristaps
Branch: MAIN
Changes since 1.137: +171 -110 lines
Diff to previous 1.137 (colored)

Added documentation for several more macros.  Only a few remaining!

Applied "new-sentence, new-line" here and there.

Refer to "whitespace", not "white-space".

Remove long-commented-out CAVEATS, all of which have been addressed or
at least discussed to some extent or another.

Revision 1.137 / (download) - annotate - [select for diffs], Mon Jul 19 10:48:36 2010 UTC (10 years ago) by kristaps
Branch: MAIN
Changes since 1.136: +6 -3 lines
Diff to previous 1.136 (colored)

Note discarding of \m, \M, and \s in COMPATIBILITY sections.

Revision 1.136 / (download) - annotate - [select for diffs], Mon Jul 19 09:19:22 2010 UTC (10 years ago) by kristaps
Branch: MAIN
Changes since 1.135: +3 -24 lines
Diff to previous 1.135 (colored)

Removed \s documentation, as we (1) never supported it, and (2) never
will.

Also whack the dot-separator from the embedded man.7 manual.

Revision 1.135 / (download) - annotate - [select for diffs], Fri Jul 16 21:09:39 2010 UTC (10 years ago) by kristaps
Branch: MAIN
Changes since 1.134: +4 -4 lines
Diff to previous 1.134 (colored)

Fixed dquote to be \*q.

Revision 1.134 / (download) - annotate - [select for diffs], Thu Jul 15 23:50:15 2010 UTC (10 years ago) by schwarze
Branch: MAIN
Changes since 1.133: +13 -1 lines
Diff to previous 1.133 (colored)

document .Sm; prodded by kristaps@

Revision 1.133 / (download) - annotate - [select for diffs], Tue Jul 6 11:07:21 2010 UTC (10 years, 1 month ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_10_4
Changes since 1.132: +14 -12 lines
Diff to previous 1.132 (colored)

Clarified `Bk' operation in mdoc.7.

Revision 1.132 / (download) - annotate - [select for diffs], Tue Jul 6 10:55:50 2010 UTC (10 years, 1 month ago) by kristaps
Branch: MAIN
Changes since 1.131: +111 -2 lines
Diff to previous 1.131 (colored)

Documented `En', `Es', `Hf', `Ic', `Lp', `Nd', `No', `Oc', `Oo', `Op',
`Pa', `Pc', `Po', `Pq', `Pp', and `Va'.

Revision 1.131 / (download) - annotate - [select for diffs], Mon Jul 5 13:12:32 2010 UTC (10 years, 1 month ago) by kristaps
Branch: MAIN
Changes since 1.130: +58 -17 lines
Diff to previous 1.130 (colored)

Manual clean-ups.  Add syntax message for `Bd', `Bk', and `Bl'.
Document `Eo' and `Ec'.  Add context-end notes `Ec' and `Fc'.

Revision 1.130 / (download) - annotate - [select for diffs], Sun Jul 4 22:04:04 2010 UTC (10 years, 1 month ago) by schwarze
Branch: MAIN
Changes since 1.129: +4 -3 lines
Diff to previous 1.129 (colored)

Assert my copyright, making it explicit that i'm granting the same license
on those parts of the code and text that i have written as Kristaps is.
"fine with me" kristaps@

Revision 1.129 / (download) - annotate - [select for diffs], Fri Jul 2 13:07:46 2010 UTC (10 years, 1 month ago) by kristaps
Branch: MAIN
Changes since 1.128: +40 -2 lines
Diff to previous 1.128 (colored)

Add documentation for Bf/Ef.

Revision 1.128 / (download) - annotate - [select for diffs], Thu Jul 1 15:38:56 2010 UTC (10 years, 1 month ago) by schwarze
Branch: MAIN
Changes since 1.127: +62 -2 lines
Diff to previous 1.127 (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.127 / (download) - annotate - [select for diffs], Sun Jun 27 13:30:51 2010 UTC (10 years, 1 month ago) by schwarze
Branch: MAIN
CVS Tags: VERSION_1_10_3
Changes since 1.126: +22 -1 lines
Diff to previous 1.126 (colored)

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

Revision 1.126 / (download) - annotate - [select for diffs], Sat Jun 12 11:41:50 2010 UTC (10 years, 1 month ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_10_2
Changes since 1.125: +11 -18 lines
Diff to previous 1.125 (colored)

Removed stipulation that an empty `Bd -offset' will default to 6n.  Not
sure where this came about.  Added regression tests to convince myself
that this is so.  Also consolidated COMPATIBILITY notes regarding `Bd'.
Added COMPATIBILITY note to the effect that old groff pukes on `Bd
-compact -ragged' (regression test will fail on old groff).

Revision 1.125 / (download) - annotate - [select for diffs], Sat Jun 12 10:09:19 2010 UTC (10 years, 1 month ago) by kristaps
Branch: MAIN
Changes since 1.124: +7 -1 lines
Diff to previous 1.124 (colored)

Added enum mdoc_disp (similar to enum mdoc_list).  Display types are now
only calculated once in mdoc_validate.c.

Noted that `Bd -file xxx' is not supported:  it now raises a fatal
warning.  This is noted in mdoc.7.

Empty `Bd' now defaults to LIST_ragged, which is not quite what groff
does, but close enough (gross just throws away the `Bd' and gets upset
when it encounters an `Ed').

Revision 1.124 / (download) - annotate - [select for diffs], Mon Jun 7 12:20:07 2010 UTC (10 years, 2 months ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_10_1
Changes since 1.123: +7 -7 lines
Diff to previous 1.123 (colored)

Added version bits for 1.10.1.

Spell-checked manuals.

Revision 1.123 / (download) - annotate - [select for diffs], Mon Jun 7 11:14:13 2010 UTC (10 years, 2 months ago) by kristaps
Branch: MAIN
Changes since 1.122: +4 -4 lines
Diff to previous 1.122 (colored)

I really should run -Tlint on my own manuals before committing them.
EOLN whitespace fixed.

Revision 1.122 / (download) - annotate - [select for diffs], Mon Jun 7 11:01:15 2010 UTC (10 years, 2 months ago) by kristaps
Branch: MAIN
Changes since 1.121: +47 -46 lines
Diff to previous 1.121 (colored)

Normalise SYNOPSIS behaviour after I gave up on following groff's
inconsistent behaviour.  In short:

       Some macros are displayed differently in the SYNOPSIS
       section, particularly Nm, Cd, Fd, Fn, Fo, In, Vt, and Ft.
       All of these macros are output on their own line.  If two
       such dissimilar macros are pair-wise invoked (except for Ft
       before Fo or Fn), they are separated by a vertical space,
       unless in the case of Fo, Fn, and Ft, which are always
       separated by vertical space.

Behaviour ok Jason McIntyre, ingo@.  Fallout will be treated
case-by-case.

I had to clear out some regressions that were testing against groff's
stranger behaviours: these will now break, as we don't care about such
invocations.

Also removed the newline for `Cd' invocation in a non-SYNOPSIS context.

Revision 1.121 / (download) - annotate - [select for diffs], Sun Jun 6 22:25:56 2010 UTC (10 years, 2 months ago) by kristaps
Branch: MAIN
Changes since 1.120: +5 -5 lines
Diff to previous 1.120 (colored)

Small fix to preserve trailing semicolons in examples.

Revision 1.120 / (download) - annotate - [select for diffs], Sun Jun 6 10:49:56 2010 UTC (10 years, 2 months ago) by kristaps
Branch: MAIN
Changes since 1.119: +150 -36 lines
Diff to previous 1.119 (colored)

Shortened "its calling syntax" -> "its syntax".

Better documentation for `Fa' and some others.

Added `Ft', `Fo', and some COMPATIBILITY notes.

Revision 1.119 / (download) - annotate - [select for diffs], Fri Jun 4 22:16:27 2010 UTC (10 years, 2 months ago) by kristaps
Branch: MAIN
Changes since 1.118: +34 -1 lines
Diff to previous 1.118 (colored)

Fixed `Fn' newline behaviour and added some regression tests to this
extent.

Documented `Fn'.  Please note the COMPATIBILITY note regarding historic
groff.

Revision 1.118 / (download) - annotate - [select for diffs], Fri Jun 4 21:49:39 2010 UTC (10 years, 2 months ago) by kristaps
Branch: MAIN
Changes since 1.117: +23 -4 lines
Diff to previous 1.117 (colored)

Documented `In' in full.

Fixed `In' to behave properly: it wasn't properly breaking lines,
formatting, or really anything else.  Noted COMPATIBILITY with
OpenBSD's groff, which pukes all over `In'.

Revision 1.117 / (download) - annotate - [select for diffs], Fri Jun 4 20:57:26 2010 UTC (10 years, 2 months ago) by kristaps
Branch: MAIN
Changes since 1.116: +38 -1 lines
Diff to previous 1.116 (colored)

Documented `Db', `El', `Fa', and `Fd'.

Revision 1.116 / (download) - annotate - [select for diffs], Thu Jun 3 15:54:27 2010 UTC (10 years, 2 months ago) by kristaps
Branch: MAIN
Changes since 1.115: +10 -1 lines
Diff to previous 1.115 (colored)

Document the `Mt' macro.

Revision 1.115 / (download) - annotate - [select for diffs], Thu Jun 3 14:52:32 2010 UTC (10 years, 2 months ago) by kristaps
Branch: MAIN
Changes since 1.114: +7 -2 lines
Diff to previous 1.114 (colored)

Compatibility note about `Ta' being a line macro.

Revision 1.114 / (download) - annotate - [select for diffs], Thu Jun 3 14:29:52 2010 UTC (10 years, 2 months ago) by kristaps
Branch: MAIN
Changes since 1.113: +97 -18 lines
Diff to previous 1.113 (colored)

Complete, rigorous documentation of the `Bl' and `It' macros, including
the peculiarities with `It'-less `Bl -column' invocations, column
phrases, per-type syntax of `It', etc.

Revision 1.113 / (download) - annotate - [select for diffs], Wed Jun 2 12:01:00 2010 UTC (10 years, 2 months ago) by kristaps
Branch: MAIN
Changes since 1.112: +2 -5 lines
Diff to previous 1.112 (colored)

Strip empty-line markers from mdoc.template and its mdoc.7 embedded form
(as per Jason McIntyre's suggestion for manuals in general).

Revision 1.112 / (download) - annotate - [select for diffs], Mon May 31 10:19:31 2010 UTC (10 years, 2 months ago) by kristaps
Branch: MAIN
Changes since 1.111: +5 -5 lines
Diff to previous 1.111 (colored)

Fix unescaped `Ta' invocations in mdoc.7.

Revision 1.111 / (download) - annotate - [select for diffs], Sun May 30 11:00:53 2010 UTC (10 years, 2 months ago) by kristaps
Branch: MAIN
Changes since 1.110: +9 -7 lines
Diff to previous 1.110 (colored)

Made `Dt' default to LOCAL and UNKNOWN instead of local and unknown (note case).

Have `Dt' default to UNKNOWN if it's an empty string.

Raise a warning if `Dt' title isn't capitalised.

Sync'd `Dt' documentation with reality.

Revision 1.110 / (download) - annotate - [select for diffs], Wed May 26 10:39:35 2010 UTC (10 years, 2 months ago) by kristaps
Branch: MAIN
Changes since 1.109: +4 -2 lines
Diff to previous 1.109 (colored)

Documented `Ud'.

Proper EOS handling for `Rv', `Ex', `Ud', and `Bt'.

Both `Bt' and `Ud' now warn about and discard line arguments (reported
by Ulrich Spoerlein).

Collapsed posts_xr into posts_wtext (harmless: they're the same thing).

Added regressions for `Ud' and `Bt'.

Revision 1.109 / (download) - annotate - [select for diffs], Wed May 26 09:35:35 2010 UTC (10 years, 2 months ago) by kristaps
Branch: MAIN
Changes since 1.108: +26 -2 lines
Diff to previous 1.108 (colored)

Fixed `Lb' to be in_line (reported by Ulrich Spoerlein).

Added `Lb' documentation to mdoc.7.

Removed harmless but superfluous pre_lb check (was just NULL entries).

Added regressions for `Lb' (NOTE that these will only run on new groff,
as old groff doesn't support `Lb' at all).

Revision 1.108 / (download) - annotate - [select for diffs], Sat May 15 16:24:37 2010 UTC (10 years, 2 months ago) by kristaps
Branch: MAIN
Changes since 1.107: +4 -4 lines
Diff to previous 1.107 (colored)

LIBRARY can also occur in section 9.
All manual sections (unknown, 3p, 3f, etc.) correctly handled by -mdoc.
Useful warning printed if unknown manual section.
Checking for manual sections (e.g., LIBRARY) checks only first character, so 3p, 3f, etc. are free.

Revision 1.107 / (download) - annotate - [select for diffs], Sat May 15 07:01:51 2010 UTC (10 years, 2 months ago) by kristaps
Branch: MAIN
Changes since 1.106: +11 -3 lines
Diff to previous 1.106 (colored)

Documented EOS buffered spaces and added `]'.

Revision 1.106 / (download) - annotate - [select for diffs], Fri May 14 17:31:25 2010 UTC (10 years, 2 months ago) by kristaps
Branch: MAIN
Changes since 1.105: +3 -2 lines
Diff to previous 1.105 (colored)

Backed out check for `Ex' manual sec (ok schwarze@, joerg@), in turn backing out check_msec() and deps.

Revision 1.105 / (download) - annotate - [select for diffs], Fri May 14 16:02:29 2010 UTC (10 years, 2 months ago) by kristaps
Branch: MAIN
Changes since 1.104: +7 -1 lines
Diff to previous 1.104 (colored)

"Warn on unknown argument for .At and print it like [new] groff." (patch by Joerg Sonnenberger, ed. Kristaps)
Keep short-log of commits in index.sgml.
Document compatibility with new/old groff in mdoc.7.

Revision 1.104 / (download) - annotate - [select for diffs], Fri May 14 15:17:23 2010 UTC (10 years, 2 months ago) by kristaps
Branch: MAIN
Changes since 1.103: +40 -1 lines
Diff to previous 1.103 (colored)

Finish initial documentation of the Bl lists.

Revision 1.103 / (download) - annotate - [select for diffs], Fri May 14 15:02:03 2010 UTC (10 years, 2 months ago) by kristaps
Branch: MAIN
Changes since 1.102: +70 -56 lines
Diff to previous 1.102 (colored)

Re-addition of cleaned-up list documentation in mdoc.7.

Revision 1.102 / (download) - annotate - [select for diffs], Fri May 14 14:21:17 2010 UTC (10 years, 2 months ago) by kristaps
Branch: MAIN
Changes since 1.101: +4 -1 lines
Diff to previous 1.101 (colored)

Added documentation bits.

Revision 1.101 / (download) - annotate - [select for diffs], Wed May 12 17:08:03 2010 UTC (10 years, 2 months ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_9_25
Changes since 1.100: +7 -1 lines
Diff to previous 1.100 (colored)

Put the eos-checker into libmandoc.h.
Added bits in mdoc.7 and man.7 about EOS spacing.

Revision 1.100 / (download) - annotate - [select for diffs], Wed May 12 16:45:18 2010 UTC (10 years, 2 months ago) by kristaps
Branch: MAIN
Changes since 1.99: +197 -146 lines
Diff to previous 1.99 (colored)

End of sentence, end of line for mdoc.7.

Revision 1.99 / (download) - annotate - [select for diffs], Wed May 12 08:41:17 2010 UTC (10 years, 2 months ago) by kristaps
Branch: MAIN
Changes since 1.98: +14 -14 lines
Diff to previous 1.98 (colored)

mdoc_atosec -> mdoc_str2sec (consistent with str2 being different from a2).
Changed ordering of sections (EXIT STATUS moved around), argued for by Ulrich Sporlein.
Fixed mdoc_str2sec not to use weird structure.

Revision 1.98 / (download) - annotate - [select for diffs], Sat May 8 22:26:39 2010 UTC (10 years, 3 months ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_9_24
Changes since 1.97: +2 -2 lines
Diff to previous 1.97 (colored)

Adding initial mailing list section to homepage.

Revision 1.97 / (download) - annotate - [select for diffs], Sat May 8 10:28:24 2010 UTC (10 years, 3 months ago) by kristaps
Branch: MAIN
Changes since 1.96: +4 -3 lines
Diff to previous 1.96 (colored)

Note that whitespace is really only the space character.

Revision 1.96 / (download) - annotate - [select for diffs], Sat May 8 08:36:44 2010 UTC (10 years, 3 months ago) by kristaps
Branch: MAIN
Changes since 1.95: +6 -16 lines
Diff to previous 1.95 (colored)

Strip trailing, unescaped whitespace from free-form, non-literal lines (like groff).

Revision 1.95 / (download) - annotate - [select for diffs], Fri May 7 15:49:36 2010 UTC (10 years, 3 months ago) by kristaps
Branch: MAIN
Changes since 1.94: +2 -6 lines
Diff to previous 1.94 (colored)

De-chunking of text removed from parsers.  This is a significant change (and I don't really like it), but it's what groff does.
Distinction of ARGS_PHRASE and ARGS_PPHRASE in backend (not yet used).

Revision 1.94 / (download) - annotate - [select for diffs], Tue Apr 13 05:26:49 2010 UTC (10 years, 3 months ago) by kristaps
Branch: MAIN
Changes since 1.93: +3 -160 lines
Diff to previous 1.93 (colored)

As per Jason McIntyre's heartful urgings, do away with '.' separators between logical sections.
Change email address to BSD.lv one (this is not an academic project...)

Revision 1.93 / (download) - annotate - [select for diffs], Wed Apr 7 19:37:54 2010 UTC (10 years, 4 months ago) by kristaps
Branch: MAIN
Changes since 1.92: +55 -43 lines
Diff to previous 1.92 (colored)

Added some clarifying bits to mdoc.7 regarding GNU troff, mandoc, and Heirloom troff.  Bits on Heirloom troff suggested from private communication with Gunnar Ritter (maintainer of Heirloom troff) (Heirloom uses BSD-4.4 mdoc files, from which historic groff -mdoc descends).

Revision 1.92 / (download) - annotate - [select for diffs], Wed Apr 7 18:50:35 2010 UTC (10 years, 4 months ago) by kristaps
Branch: MAIN
Changes since 1.91: +3 -3 lines
Diff to previous 1.91 (colored)

Allowing `Cd' to be in section 9 (noted by Joerg Sonnenberger).

Revision 1.91 / (download) - annotate - [select for diffs], Wed Apr 7 08:17:16 2010 UTC (10 years, 4 months ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_9_23
Changes since 1.90: +67 -129 lines
Diff to previous 1.90 (colored)

Breaking mdoc.7's multiline examples into sets of D1.  A few errors found here and there.

Revision 1.90 / (download) - annotate - [select for diffs], Tue Apr 6 17:01:27 2010 UTC (10 years, 4 months ago) by kristaps
Branch: MAIN
Changes since 1.89: +2 -2 lines
Diff to previous 1.89 (colored)

Removed warning for `Er' when not used in certain sections (pointed out by Joerg Sonnenberger).

Revision 1.89 / (download) - annotate - [select for diffs], Tue Apr 6 11:19:57 2010 UTC (10 years, 4 months ago) by kristaps
Branch: MAIN
Changes since 1.88: +6 -4 lines
Diff to previous 1.88 (colored)

Note on `Fl' documented in mdoc.7.

Revision 1.88 / (download) - annotate - [select for diffs], Tue Apr 6 07:17:51 2010 UTC (10 years, 4 months ago) by kristaps
Branch: MAIN
Changes since 1.87: +3 -3 lines
Diff to previous 1.87 (colored)

Fix mdoc bug found by Claus Assmann: `Pf' should be callable.

Revision 1.87 / (download) - annotate - [select for diffs], Wed Mar 31 07:13:53 2010 UTC (10 years, 4 months ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_9_22
Changes since 1.86: +9 -2 lines
Diff to previous 1.86 (colored)

Macro types enum-ated (enum mdoct) (for easier debugging in gdb of "tok" values).
Initial check-in of Ingo Schwarze's patch for Xo/Xc handling (in blocks ifdef'd "UGLY").
Put Oc-close-Op parts into UGLY ifdef blocks.

Revision 1.86 / (download) - annotate - [select for diffs], Fri Mar 26 07:07:58 2010 UTC (10 years, 4 months ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_9_21, VERSION_1_9_20, VERSION_1_9_19, VERSION_1_9_18
Changes since 1.85: +3 -3 lines
Diff to previous 1.85 (colored)

Fixed misspelt "Loongson" (noted by Ingo Schwarze).

Revision 1.85 / (download) - annotate - [select for diffs], Sun Mar 21 18:16:41 2010 UTC (10 years, 4 months ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_9_17, VERSION_1_9_16
Changes since 1.84: +3 -2 lines
Diff to previous 1.84 (colored)

Added Longsoon architecture (thanks Jason McIntyre, Ingo Schwarze).

Revision 1.84 / (download) - annotate - [select for diffs], Wed Feb 17 19:22:50 2010 UTC (10 years, 5 months ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_9_15
Changes since 1.83: +34 -3 lines
Diff to previous 1.83 (colored)

Macro documentation for `Xr'.
Re-added macros following `Vt' (lost somehow?).
Removed `Xr' <3 stipulations.

Revision 1.83 / (download) - annotate - [select for diffs], Sat Jan 30 08:55:39 2010 UTC (10 years, 6 months ago) by kristaps
Branch: MAIN
Changes since 1.82: +33 -6 lines
Diff to previous 1.82 (colored)

Added `Vt' double-type documentation.

Revision 1.82 / (download) - annotate - [select for diffs], Thu Jan 7 19:10:10 2010 UTC (10 years, 7 months ago) by kristaps
Branch: MAIN
Changes since 1.81: +22 -22 lines
Diff to previous 1.81 (colored)

Fix white-space issues found by mandoc's better white-space finder.
Fixed bogus `\\' escapes in some manuals.

Revision 1.81 / (download) - annotate - [select for diffs], Fri Jan 1 16:52:00 2010 UTC (10 years, 7 months ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_9_15-pre2, VERSION_1_9_15-pre1
Changes since 1.80: +5 -1 lines
Diff to previous 1.80 (colored)

Noted non-accepted comment syntax (thanks Joerg Sonnenberger).

Revision 1.80 / (download) - annotate - [select for diffs], Fri Jan 1 16:27:32 2010 UTC (10 years, 7 months ago) by kristaps
Branch: MAIN
Changes since 1.79: +80 -6 lines
Diff to previous 1.79 (colored)

Issue of `Pa' put to rest by Jason McIntyre.  Noted in COMPATIBILITY.

Revision 1.79 / (download) - annotate - [select for diffs], Fri Jan 1 13:35:30 2010 UTC (10 years, 7 months ago) by kristaps
Branch: MAIN
Changes since 1.78: +23 -1 lines
Diff to previous 1.78 (colored)

Documented `Fl' in mdoc.7.
Backed out stipulation that `Fl ""' is ignored: this is not the case in !OpenBSD groffs.

Revision 1.78 / (download) - annotate - [select for diffs], Mon Nov 16 09:52:47 2009 UTC (10 years, 8 months ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_9_14
Changes since 1.77: +5 -5 lines
Diff to previous 1.77 (colored)

More clarification in manuals.  Added per-OUTPUT section in mandoc.1.

Revision 1.77 / (download) - annotate - [select for diffs], Thu Nov 12 05:50:12 2009 UTC (10 years, 8 months ago) by kristaps
Branch: MAIN
Changes since 1.76: +24 -5 lines
Diff to previous 1.76 (colored)

Basically re-wrote -Tascii font handling: instead of incrementers for
bold and underline, we use a stack (no cascading, no double-font-mode).
Font modes with \f only affect the current stack point, as documented in
mdoc.7 and man.7.  While -mdoc stacks fonts with embedded macros, -man
replaces them (the stack is always size 1).  This works for all
invocations in supported systems' manual corpora to date.  It doesn't
support groff's insanity with line-scoped \f as documented in mdoc.7.

Revision 1.76 / (download) - annotate - [select for diffs], Mon Nov 9 05:11:46 2009 UTC (10 years, 8 months ago) by kristaps
Branch: MAIN
Changes since 1.75: +31 -4 lines
Diff to previous 1.75 (colored)

Documented \s and cleaned up \f documentation in mdoc.7, man.7.
-Thtml now using a2roffdeco().

Revision 1.75 / (download) - annotate - [select for diffs], Fri Nov 6 10:31:31 2009 UTC (10 years, 9 months ago) by kristaps
Branch: MAIN
Changes since 1.74: +4 -3 lines
Diff to previous 1.74 (colored)

-Tascii now correctly ignores \s clauses.

Revision 1.74 / (download) - annotate - [select for diffs], Thu Nov 5 08:40:16 2009 UTC (10 years, 9 months ago) by kristaps
Branch: MAIN
Changes since 1.73: +6 -4 lines
Diff to previous 1.73 (colored)

Correct support for `\fX' font modes in -Tascii.

Revision 1.73 / (download) - annotate - [select for diffs], Mon Nov 2 11:39:40 2009 UTC (10 years, 9 months ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_9_13
Changes since 1.72: +179 -32 lines
Diff to previous 1.72 (colored)

Copied over and modified manual structure from man.7.

Revision 1.72 / (download) - annotate - [select for diffs], Mon Nov 2 06:22:45 2009 UTC (10 years, 9 months ago) by kristaps
Branch: MAIN
Changes since 1.71: +10 -21 lines
Diff to previous 1.71 (colored)

Added mandoc_a2time() for proper date conversion.
Fitted TH and Dd handlers to use mandoc_a2time().
Documented date syntax for -man, fixed documentation for -mdoc.

Revision 1.71 / (download) - annotate - [select for diffs], Sat Oct 31 06:50:25 2009 UTC (10 years, 9 months ago) by kristaps
Branch: MAIN
Changes since 1.70: +2 -2 lines
Diff to previous 1.70 (colored)

Patch on DragonFly BSD syntax (thanks Sascha Wildner).
Noted inclusion into DragonFly BSD (thanks Sascha Wildner).

Revision 1.70 / (download) - annotate - [select for diffs], Mon Oct 26 04:09:45 2009 UTC (10 years, 9 months ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_9_12, VERSION_1_9_11, VERSION_1_9_10
Changes since 1.69: +15 -2 lines
Diff to previous 1.69 (colored)

Full `%U' support.
`Lk' display fixed.
Renamed arg2xxxx as a2xxxx for consistency.
Renamed print_foot to print_man_foot for consistency.
Removed default printing of `~' when `Lk' not provided (not sure where I got that from).

Revision 1.69 / (download) - annotate - [select for diffs], Sat Oct 24 05:52:13 2009 UTC (10 years, 9 months ago) by kristaps
Branch: MAIN
Changes since 1.68: +6 -1 lines
Diff to previous 1.68 (colored)

Added `%U' to -mdoc (doesn't render in a nice way yet).

Revision 1.68 / (download) - annotate - [select for diffs], Thu Oct 22 10:36:20 2009 UTC (10 years, 9 months ago) by kristaps
Branch: MAIN
Changes since 1.67: +2 -2 lines
Diff to previous 1.67 (colored)

Typo in mdoc.7 fixed (thanks to Joerg Sonnenberger).

Revision 1.67 / (download) - annotate - [select for diffs], Thu Oct 22 10:33:28 2009 UTC (10 years, 9 months ago) by kristaps
Branch: MAIN
Changes since 1.66: +2 -2 lines
Diff to previous 1.66 (colored)

Groff-compatibility fix (Ds) (noted by Joerg Sonnenberger).

Revision 1.66 / (download) - annotate - [select for diffs], Tue Oct 20 05:45:21 2009 UTC (10 years, 9 months ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_9_9
Changes since 1.65: +451 -22 lines
Diff to previous 1.65 (colored)

More updates to mdoc.7.

Revision 1.65 / (download) - annotate - [select for diffs], Mon Oct 19 11:02:23 2009 UTC (10 years, 9 months ago) by kristaps
Branch: MAIN
Changes since 1.64: +175 -12 lines
Diff to previous 1.64 (colored)

Continued work on mdoc.7.
Noted buffer overwrite bug in -Thtml -mdoc (will fix later).

Revision 1.64 / (download) - annotate - [select for diffs], Mon Oct 19 10:18:05 2009 UTC (10 years, 9 months ago) by kristaps
Branch: MAIN
Changes since 1.63: +421 -225 lines
Diff to previous 1.63 (colored)

Fixed -mdoc -Thtml with -item lists not to default-indent when width isn't specified.
Many more cleanups to mdoc.7 (ongoing completion and documentation of all macros).

Revision 1.63 / (download) - annotate - [select for diffs], Mon Oct 19 07:34:43 2009 UTC (10 years, 9 months ago) by kristaps
Branch: MAIN
Changes since 1.62: +264 -17 lines
Diff to previous 1.62 (colored)

Beginning of mdoc.7 full-reference in place.

Revision 1.62 / (download) - annotate - [select for diffs], Sun Oct 18 19:01:24 2009 UTC (10 years, 9 months ago) by kristaps
Branch: MAIN
Changes since 1.61: +2 -2 lines
Diff to previous 1.61 (colored)

Fix in syntax of scaling widths in mdoc.7.

Revision 1.61 / (download) - annotate - [select for diffs], Sun Oct 18 13:58:48 2009 UTC (10 years, 9 months ago) by kristaps
Branch: MAIN
Changes since 1.60: +62 -1 lines
Diff to previous 1.60 (colored)

Fixed typo in Makefile.
Added initial scaling-units section in mdoc.7.

Revision 1.60 / (download) - annotate - [select for diffs], Mon Sep 28 22:09:08 2009 UTC (10 years, 10 months ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_9_8, VERSION_1_9_7
Changes since 1.59: +3 -3 lines
Diff to previous 1.59 (colored)

Compat fix in mdoc.7 (joerg@netbsd.org).

Revision 1.59 / (download) - annotate - [select for diffs], Thu Aug 20 13:32:09 2009 UTC (10 years, 11 months ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_9_6, VERSION_1_9_5, VERSION_1_9_2, VERSION_1_9_1
Changes since 1.58: +2 -1 lines
Diff to previous 1.58 (colored)

Synchronised man.7, mdoc.7, mdoc.template manual structure.

Revision 1.58 / (download) - annotate - [select for diffs], Thu Aug 20 13:22:48 2009 UTC (10 years, 11 months ago) by kristaps
Branch: MAIN
Changes since 1.57: +40 -6 lines
Diff to previous 1.57 (colored)

Updated manual structure in mdoc.7.
Synchronised mdoc.template and mdoc.7 manual structure.
`Rv' and `Ex' now accept multiple arguments (-std made standalone, terms as children).
`Rv' and `Ex' format correctly in -Tascii (plurals, commas, etc.).

Revision 1.57 / (download) - annotate - [select for diffs], Thu Aug 20 12:08:40 2009 UTC (10 years, 11 months ago) by kristaps
Branch: MAIN
Changes since 1.56: +367 -349 lines
Diff to previous 1.56 (colored)

Documented omission of `na' and `Dt'.
Clarified COMPATIBILITY section (which modes/inputs).

Revision 1.56 / (download) - annotate - [select for diffs], Tue Aug 18 14:27:16 2009 UTC (10 years, 11 months ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_9_0
Changes since 1.55: +398 -409 lines
Diff to previous 1.55 (colored)

libmdoc accepts whitespace following control character.

Revision 1.55 / (download) - annotate - [select for diffs], Wed Jul 29 08:58:11 2009 UTC (11 years ago) by kristaps
Branch: MAIN
Changes since 1.54: +14 -3 lines
Diff to previous 1.54 (colored)

Documented behaviour of interpreting parsable/callable macros.

Revision 1.54 / (download) - annotate - [select for diffs], Mon Jul 27 12:35:54 2009 UTC (11 years ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_8_5
Changes since 1.53: +35 -30 lines
Diff to previous 1.53 (colored)

Clarified special chars/predefined chars in mandoc_char.7.
Cleaned up escape section in man.7, mdoc.7.
Cleaned up function names in term.c.

Revision 1.53 / (download) - annotate - [select for diffs], Sun Jul 26 19:30:50 2009 UTC (11 years ago) by kristaps
Branch: MAIN
Changes since 1.52: +1 -9 lines
Diff to previous 1.52 (colored)

Removed POSIX.1 COMPATIBILITY note in mdoc.7.
Noted that \~ doesn't work in mandoc.1 (thanks uqs@sporlein.net).

Revision 1.52 / (download) - annotate - [select for diffs], Sun Jul 26 10:14:22 2009 UTC (11 years ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_8_4
Changes since 1.51: +9 -1 lines
Diff to previous 1.51 (colored)

Noted POSIX/POSIX.1 disparity (found by uqs@sporlein.net, discussed with jmc@openbsd.org et al.).

Revision 1.51 / (download) - annotate - [select for diffs], Fri Jul 24 12:47:35 2009 UTC (11 years ago) by kristaps
Branch: MAIN
Changes since 1.50: +11 -1 lines
Diff to previous 1.50 (colored)

Full support for `An -split/-nosplit'.  Compat documented.

Revision 1.50 / (download) - annotate - [select for diffs], Mon Jul 20 13:45:11 2009 UTC (11 years ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_8_3, VERSION_1_8_2
Changes since 1.49: +61 -61 lines
Diff to previous 1.49 (colored)

Removed trailing whitespace in manuals.

Revision 1.49 / (download) - annotate - [select for diffs], Sun Jul 19 09:17:42 2009 UTC (11 years ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_8_1
Changes since 1.48: +2 -2 lines
Diff to previous 1.48 (colored)

Made `Cd' parseable (too many SYNOPSIS sections do this).

Revision 1.48 / (download) - annotate - [select for diffs], Sat Jul 18 23:31:04 2009 UTC (11 years ago) by kristaps
Branch: MAIN
Changes since 1.47: +8 -18 lines
Diff to previous 1.47 (colored)

More clarity fixes in mdoc.7.
Sm/Sy argument to `Bf' fixed (schwarze@openbsd).

Revision 1.47 / (download) - annotate - [select for diffs], Sat Jul 18 18:49:19 2009 UTC (11 years ago) by kristaps
Branch: MAIN
Changes since 1.46: +33 -5 lines
Diff to previous 1.46 (colored)

Considerably revamped argument-parsing for correct quoted-literal handling.
Deprecated ARGS_QUOTED (all arguments are quotable).
Documented quotation and whitespace rules in mdoc.7.

Revision 1.46 / (download) - annotate - [select for diffs], Fri Jul 17 14:51:04 2009 UTC (11 years ago) by kristaps
Branch: MAIN
Changes since 1.45: +39 -28 lines
Diff to previous 1.45 (colored)

Better doc of whitespace handling in mdoc.7.
Doc of macro quotation in mdoc.7.

Revision 1.45 / (download) - annotate - [select for diffs], Fri Jul 17 12:40:48 2009 UTC (11 years ago) by kristaps
Branch: MAIN
Changes since 1.44: +31 -25 lines
Diff to previous 1.44 (colored)

`sp' documented: validates & produces correct output.

Revision 1.44 / (download) - annotate - [select for diffs], Fri Jul 17 12:08:08 2009 UTC (11 years ago) by kristaps
Branch: MAIN
Changes since 1.43: +67 -150 lines
Diff to previous 1.43 (colored)

Documented `br' macro in mdoc.7.
Made `Pp' and `Lp' be inline_eoln() (not sure why they weren't before).

Revision 1.43 / (download) - annotate - [select for diffs], Tue Jul 14 15:57:08 2009 UTC (11 years ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_8_0
Changes since 1.42: +379 -391 lines
Diff to previous 1.42 (colored)

Consolidated some sections.  Much more readable.

Revision 1.42 / (download) - annotate - [select for diffs], Mon Jul 13 07:23:07 2009 UTC (11 years ago) by kristaps
Branch: MAIN
Changes since 1.41: +1 -5 lines
Diff to previous 1.41 (colored)

Err/warn fix (schwarze@openbsd.org).
Lots of whitespace churn in getting functions aligned nicely.

Revision 1.41 / (download) - annotate - [select for diffs], Sun Jul 12 19:34:51 2009 UTC (11 years ago) by kristaps
Branch: MAIN
Changes since 1.40: +6 -1 lines
Diff to previous 1.40 (colored)

Fixed `Fo' superfluous space before `('. Noted groff compatibility in mdoc.7.

Revision 1.40 / (download) - annotate - [select for diffs], Sun Jul 12 16:34:16 2009 UTC (11 years ago) by kristaps
Branch: MAIN
Changes since 1.39: +2 -2 lines
Diff to previous 1.39 (colored)

`Nd' is now a BFI (was an ELEM).  Noted by joerg@netbsd.org, behaviour ok jmc@openbsd.org, etc.

Revision 1.39 / (download) - annotate - [select for diffs], Sun Jul 12 15:32:26 2009 UTC (11 years ago) by kristaps
Branch: MAIN
Changes since 1.38: +17 -17 lines
Diff to previous 1.38 (colored)

mdoc.7 using -offset indent instead of -offset XXXX or whatever it was.

Revision 1.38 / (download) - annotate - [select for diffs], Mon Jul 6 09:21:24 2009 UTC (11 years, 1 month ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_7_24, VERSION_1_7_23
Changes since 1.37: +5 -1 lines
Diff to previous 1.37 (colored)

Initial removal of enum mdoc_warn from mdoc warnings (unnecessary complication).

Revision 1.37 / (download) - annotate - [select for diffs], Sun Jul 5 19:25:10 2009 UTC (11 years, 1 month ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_7_22
Changes since 1.36: +1 -7 lines
Diff to previous 1.36 (colored)

Backed out "-width indent" and "-width indent-two", which aren't
supported by any groff mdoc tmac (and erroneously used in many manuals,
hence the confusion).

Revision 1.36 / (download) - annotate - [select for diffs], Sat Jul 4 11:04:07 2009 UTC (11 years, 1 month ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_7_21
Changes since 1.35: +7 -1 lines
Diff to previous 1.35 (colored)

Noted secret -width indent/indent-two arguments to `Bl'.

Revision 1.35 / (download) - annotate - [select for diffs], Sat Jul 4 09:00:41 2009 UTC (11 years, 1 month ago) by kristaps
Branch: MAIN
Changes since 1.34: +26 -8 lines
Diff to previous 1.34 (colored)

man.7/mdoc.7 properly reflect escape-character handling.
man.7 points to mdoc.7 for COMPATIBILITY.
Whitespace stripping noted in mdoc.7.

Revision 1.34 / (download) - annotate - [select for diffs], Thu Jun 25 11:35:28 2009 UTC (11 years, 1 month ago) by kristaps
Branch: MAIN
Changes since 1.33: +7 -1 lines
Diff to previous 1.33 (colored)

Added note about whitespace being stripped from mdoc/man input and re-added in mandoc(1).

Revision 1.33 / (download) - annotate - [select for diffs], Thu Jun 25 10:51:21 2009 UTC (11 years, 1 month ago) by kristaps
Branch: MAIN
Changes since 1.32: +25 -25 lines
Diff to previous 1.32 (colored)

Fixed STRUCTURE repeat (schwarze@openbsd.org).
Simplified some explanations (nobody cares about ontologies these days).

Revision 1.32 / (download) - annotate - [select for diffs], Mon Jun 22 13:09:17 2009 UTC (11 years, 1 month ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_7_20
Changes since 1.31: +18 -2 lines
Diff to previous 1.31 (colored)

libman documents require `TH' and at least one node.
libman requirements documented in man.7 STRUCTURE section.
Added STRUCTURE section to mdoc.7, too.

Revision 1.31 / (download) - annotate - [select for diffs], Mon Jun 22 12:22:35 2009 UTC (11 years, 1 month ago) by kristaps
Branch: MAIN
Changes since 1.30: +6 -1 lines
Diff to previous 1.30 (colored)

Added -split and -nosplit "I-Don't-Like" note to mdoc.7 (there really must be another way to do this).
Fixed .Er -width conversion.

Revision 1.30 / (download) - annotate - [select for diffs], Wed Jun 17 14:08:47 2009 UTC (11 years, 1 month ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_7_19
Changes since 1.29: +3 -3 lines
Diff to previous 1.29 (colored)

`Bl -column' now correctly handles tail entries (Bl -column -more... arg0...).

Revision 1.29 / (download) - annotate - [select for diffs], Tue Jun 16 19:13:28 2009 UTC (11 years, 1 month ago) by kristaps
Branch: MAIN
Changes since 1.28: +12 -2 lines
Diff to previous 1.28 (colored)

Modernised comment handling: text following \" is thrown away before
either parser is invoked.  Single-dot lines correctly handled.  This
confirms with both new- and old-groff.  "Comment" subsection added to
mdoc.7 and man.7.

Revision 1.28 / (download) - annotate - [select for diffs], Fri Jun 12 12:40:44 2009 UTC (11 years, 1 month ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_7_17, VERSION_1_7_16, VERSION_1_7_15
Changes since 1.27: +36 -31 lines
Diff to previous 1.27 (colored)

Made per-macro "now callable" COMPATIBILITY claims into a single "most macros callable".
Added COMPATIBILITY note on escaped special-character sequences.
Vertical bar now correctly delimits (like in new groff).

Revision 1.27 / (download) - annotate - [select for diffs], Fri Jun 12 09:18:00 2009 UTC (11 years, 1 month ago) by kristaps
Branch: MAIN
Changes since 1.26: +6 -4 lines
Diff to previous 1.26 (colored)

`Lk' is correctly handled as CALLABLE (note groff munges nested output).
`Mt' is now CALLABLE.
Fixed missing validate/action of zero-element, non-called inline elements.
Fixed missing validate/action of nested inline element re-calls.
Fixed bogus column argv index in validator.

Revision 1.26 / (download) - annotate - [select for diffs], Thu Jun 11 20:02:37 2009 UTC (11 years, 1 month ago) by kristaps
Branch: MAIN
Changes since 1.25: +5 -4 lines
Diff to previous 1.25 (colored)

`Ft' and `Ms' are now callable and compat-noted in mdoc.7 (joerg@netbsd.org).

Revision 1.25 / (download) - annotate - [select for diffs], Thu Jun 11 19:56:14 2009 UTC (11 years, 1 month ago) by kristaps
Branch: MAIN
Changes since 1.24: +4 -3 lines
Diff to previous 1.24 (colored)

`An' now callable, historic use noted in mdoc.7 (joerg@netbsd.org).

Revision 1.24 / (download) - annotate - [select for diffs], Thu Jun 11 07:26:35 2009 UTC (11 years, 1 month ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_7_14
Changes since 1.23: +2 -2 lines
Diff to previous 1.23 (colored)

Fixed email address in manual AUTHOR reference.
Set max right margin to 80 columns (schwarze@openbsd.org).
Fixed centre-field heading position (schwarze@openbsd.org).
Also fixed -Tman centre-field.

Revision 1.23 / (download) - annotate - [select for diffs], Wed Jun 10 20:18:43 2009 UTC (11 years, 1 month ago) by kristaps
Branch: MAIN
Changes since 1.22: +2 -2 lines
Diff to previous 1.22 (colored)

Fixed license email address.

Revision 1.22 / (download) - annotate - [select for diffs], Sun Apr 12 19:45:26 2009 UTC (11 years, 3 months ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_7_13
Changes since 1.21: +10 -12 lines
Diff to previous 1.21 (colored)

Using proper license template (const).

Revision 1.21 / (download) - annotate - [select for diffs], Sun Apr 12 19:30:45 2009 UTC (11 years, 3 months ago) by kristaps
Branch: MAIN
Changes since 1.20: +3 -3 lines
Diff to previous 1.20 (colored)

Spelling "preceed" -> "precede" (naddy).

Revision 1.20 / (download) - annotate - [select for diffs], Sun Apr 12 19:19:57 2009 UTC (11 years, 3 months ago) by kristaps
Branch: MAIN
Changes since 1.19: +2 -2 lines
Diff to previous 1.19 (colored)

Manual .Dt fields CAPITALISED.
Indent set to 5 chars (nroff compat).
Half-indent set to 3 chars (nroff compat).
Default behaviour is loose-y (ignore macro/char/escape).
Added -fstrict.
Added unknown-character ignoring.

Revision 1.19 / (download) - annotate - [select for diffs], Fri Mar 27 14:56:15 2009 UTC (11 years, 4 months ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_7_12, VERSION_1_7_10, OPENBSD_CHECKIN
Changes since 1.18: +4 -420 lines
Diff to previous 1.18 (colored)

Added some new manuals (mdoc.3 mandoc_char.7).
Support for .br in libman.

Revision 1.18 / (download) - annotate - [select for diffs], Fri Mar 27 13:44:24 2009 UTC (11 years, 4 months ago) by kristaps
Branch: MAIN
Changes since 1.17: +3 -1 lines
Diff to previous 1.17 (colored)

Fixes in going over all OpenBSD manuals.

Revision 1.17 / (download) - annotate - [select for diffs], Thu Mar 26 23:01:26 2009 UTC (11 years, 4 months ago) by kristaps
Branch: MAIN
Changes since 1.16: +5 -10 lines
Diff to previous 1.16 (colored)

Clean-ups to documentation.

Revision 1.16 / (download) - annotate - [select for diffs], Thu Mar 26 16:23:22 2009 UTC (11 years, 4 months ago) by kristaps
Branch: MAIN
Changes since 1.15: +237 -235 lines
Diff to previous 1.15 (colored)

All macro-invocations, for consistency, begin with `.' in documentation.
Fixed \\ -> \e in manual documentation.
All preliminary -man macros in place.

Revision 1.15 / (download) - annotate - [select for diffs], Mon Mar 23 16:02:56 2009 UTC (11 years, 4 months ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_7_5
Changes since 1.14: +3 -6 lines
Diff to previous 1.14 (colored)

Initial documentation in place for man.7.

Revision 1.14 / (download) - annotate - [select for diffs], Mon Mar 23 14:22:11 2009 UTC (11 years, 4 months ago) by kristaps
Branch: MAIN
Changes since 1.13: +6 -1 lines
Diff to previous 1.13 (colored)

First addition of -man macro support.
Abstraction of mdoc.

Revision 1.13 / (download) - annotate - [select for diffs], Sun Mar 22 08:52:27 2009 UTC (11 years, 4 months ago) by kristaps
Branch: MAIN
Changes since 1.12: +43 -8 lines
Diff to previous 1.12 (colored)

More documentation clarification.

Revision 1.12 / (download) - annotate - [select for diffs], Sat Mar 21 13:47:02 2009 UTC (11 years, 4 months ago) by kristaps
Branch: MAIN
Changes since 1.11: +2 -2 lines
Diff to previous 1.11 (colored)

Freed more macros from zero-length restrictions.
Fixed `Fn' spacing.

Revision 1.11 / (download) - annotate - [select for diffs], Sat Mar 21 13:37:31 2009 UTC (11 years, 4 months ago) by kristaps
Branch: MAIN
Changes since 1.10: +6 -6 lines
Diff to previous 1.10 (colored)

More macros freed from unnecessary limitations on numargs.

Revision 1.10 / (download) - annotate - [select for diffs], Fri Mar 20 15:14:01 2009 UTC (11 years, 4 months ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_6_5, VERSION_1_6_2
Changes since 1.9: +18 -2 lines
Diff to previous 1.9 (colored)

Support for `Bd' of all types (see mdoc.7 for newline/tab rules).
Renamed term.c and terminal.c functions to be term_.
Some bugfixes to lists.

Revision 1.9 / (download) - annotate - [select for diffs], Thu Mar 19 20:43:13 2009 UTC (11 years, 4 months ago) by kristaps
Branch: MAIN
Changes since 1.8: +67 -7 lines
Diff to previous 1.8 (colored)

Finished all symbols.

Revision 1.8 / (download) - annotate - [select for diffs], Thu Mar 19 18:30:26 2009 UTC (11 years, 4 months ago) by kristaps
Branch: MAIN
Changes since 1.7: +15 -1 lines
Diff to previous 1.7 (colored)

Fixed mandoc read from stdin.
Added some more groff_chars.

Revision 1.7 / (download) - annotate - [select for diffs], Thu Mar 19 11:49:00 2009 UTC (11 years, 4 months ago) by kristaps
Branch: MAIN
Changes since 1.6: +113 -13 lines
Diff to previous 1.6 (colored)

Many more ASCII escapes added.
Stripped nroff punt from mdocterm.c.
Fixed multiple-file handling for mdocterm.c.
Cleared up mdoc.h API.

Revision 1.6 / (download) - annotate - [select for diffs], Mon Mar 16 23:37:28 2009 UTC (11 years, 4 months ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_5_3
Changes since 1.5: +23 -5 lines
Diff to previous 1.5 (colored)

Changed e-mail address to @openbsd.
Cleaned up manual-page documentation.

Revision 1.5 / (download) - annotate - [select for diffs], Mon Mar 16 22:19:19 2009 UTC (11 years, 4 months ago) by kristaps
Branch: MAIN
Changes since 1.4: +184 -99 lines
Diff to previous 1.4 (colored)

Fixed mdoc_phrase escape handling.
Added MDOC_IGNDELIM (Pf, soon Li, etc.).
macro_constant_delimited ignargs -> argv.c parsing.
Renamed macro functions to correspond to ontologies.
`Fo' and `St' made callable (compat documented).
strings.sh deprecated (directly using CPP).
Abstracted ASCII translation into ascii.{c,in}.
ASCII table uses a self-reordering chained hashtable.
Removed old regressions.

Revision 1.4 / (download) - annotate - [select for diffs], Sat Mar 14 05:21:58 2009 UTC (11 years, 4 months ago) by kristaps
Branch: MAIN
CVS Tags: VERSION_1_5_1
Changes since 1.3: +128 -44 lines
Diff to previous 1.3 (colored)

mdoc.3 refers to local mdoc.7.
mdoc.7 includes its compatibility with system-dependent roff installations.

Revision 1.3 / (download) - annotate - [select for diffs], Fri Mar 13 13:56:13 2009 UTC (11 years, 4 months ago) by kristaps
Branch: MAIN
Changes since 1.2: +81 -71 lines
Diff to previous 1.2 (colored)

Finished initial mdoc.7.

Revision 1.2 / (download) - annotate - [select for diffs], Fri Mar 13 09:08:59 2009 UTC (11 years, 4 months ago) by kristaps
Branch: MAIN
Changes since 1.1: +171 -111 lines
Diff to previous 1.1 (colored)

Updating mdoc.7.

Revision 1.1 / (download) - annotate - [select for diffs], Fri Mar 13 07:46:10 2009 UTC (11 years, 4 months ago) by kristaps
Branch: MAIN

Added canonical mdoc.7.
Added \q macro.

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