summaryrefslogtreecommitdiffstats
path: root/mdoc.7
Commit message (Collapse)AuthorAgeFilesLines
* All macros in mdoc.7 are now documented.Kristaps Dzonsons2010-07-191-14/+52
|
* Finished document -mdoc macros. Note `br' and `sp' remain.Kristaps Dzonsons2010-07-191-6/+120
| | | | | Noted in arch.in and st.in that mdoc.7 must be updated if entries are added.
* Added documentation for several more macros. Only a few remaining!Kristaps Dzonsons2010-07-191-109/+170
| | | | | | | | | 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.
* Note discarding of \m, \M, and \s in COMPATIBILITY sections.Kristaps Dzonsons2010-07-191-1/+4
|
* Removed \s documentation, as we (1) never supported it, and (2) neverKristaps Dzonsons2010-07-191-22/+1
| | | | | | will. Also whack the dot-separator from the embedded man.7 manual.
* Fixed dquote to be \*q.Kristaps Dzonsons2010-07-161-2/+2
|
* document .Sm; prodded by kristaps@Ingo Schwarze2010-07-151-0/+12
|
* Clarified `Bk' operation in mdoc.7.Kristaps Dzonsons2010-07-061-10/+12
|
* Documented `En', `Es', `Hf', `Ic', `Lp', `Nd', `No', `Oc', `Oo', `Op',Kristaps Dzonsons2010-07-061-0/+109
| | | | `Pa', `Pc', `Po', `Pq', `Pp', and `Va'.
* Manual clean-ups. Add syntax message for `Bd', `Bk', and `Bl'.Kristaps Dzonsons2010-07-051-15/+56
| | | | Document `Eo' and `Ec'. Add context-end notes `Ec' and `Fc'.
* Assert my copyright, making it explicit that i'm granting the same licenseIngo Schwarze2010-07-041-1/+2
| | | | | on those parts of the code and text that i have written as Kristaps is. "fine with me" kristaps@
* Add documentation for Bf/Ef.Kristaps Dzonsons2010-07-021-0/+38
|
* Improve .Nm indentation in the SYNOPSIS;Ingo Schwarze2010-07-011-0/+60
| | | | | | | kristaps@ will do the missing HTML part soon. "looks nicer" jmc@ "seems perfect to me" sobrado@ "slap it in" kristaps@
* Document .Bk and .Ek; reminded by kristaps@.Ingo Schwarze2010-06-271-0/+21
|
* Removed stipulation that an empty `Bd -offset' will default to 6n. NotKristaps Dzonsons2010-06-121-16/+9
| | | | | | | 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).
* Added enum mdoc_disp (similar to enum mdoc_list). Display types are nowKristaps Dzonsons2010-06-121-0/+6
| | | | | | | | | | | 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').
* Added version bits for 1.10.1.Kristaps Dzonsons2010-06-071-6/+6
| | | | Spell-checked manuals.
* I really should run -Tlint on my own manuals before committing them.Kristaps Dzonsons2010-06-071-2/+2
| | | | EOLN whitespace fixed.
* Normalise SYNOPSIS behaviour after I gave up on following groff'sKristaps Dzonsons2010-06-071-45/+46
| | | | | | | | | | | | | | | | | | | | | 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.
* Small fix to preserve trailing semicolons in examples.Kristaps Dzonsons2010-06-061-3/+3
|
* Shortened "its calling syntax" -> "its syntax".Kristaps Dzonsons2010-06-061-35/+149
| | | | | | Better documentation for `Fa' and some others. Added `Ft', `Fo', and some COMPATIBILITY notes.
* Fixed `Fn' newline behaviour and added some regression tests to thisKristaps Dzonsons2010-06-041-0/+33
| | | | | | | extent. Documented `Fn'. Please note the COMPATIBILITY note regarding historic groff.
* Documented `In' in full.Kristaps Dzonsons2010-06-041-2/+21
| | | | | | 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'.
* Documented `Db', `El', `Fa', and `Fd'.Kristaps Dzonsons2010-06-041-0/+37
|
* Document the `Mt' macro.Kristaps Dzonsons2010-06-031-0/+9
|
* Compatibility note about `Ta' being a line macro.Kristaps Dzonsons2010-06-031-0/+5
|
* Complete, rigorous documentation of the `Bl' and `It' macros, includingKristaps Dzonsons2010-06-031-16/+95
| | | | | the peculiarities with `It'-less `Bl -column' invocations, column phrases, per-type syntax of `It', etc.
* Strip empty-line markers from mdoc.template and its mdoc.7 embedded formKristaps Dzonsons2010-06-021-3/+0
| | | | (as per Jason McIntyre's suggestion for manuals in general).
* Fix unescaped `Ta' invocations in mdoc.7.Kristaps Dzonsons2010-05-311-3/+3
|
* Made `Dt' default to LOCAL and UNKNOWN instead of local and unknown (note case).Kristaps Dzonsons2010-05-301-6/+8
| | | | | | | | 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.
* Documented `Ud'.Kristaps Dzonsons2010-05-261-0/+2
| | | | | | | | | | | 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'.
* Fixed `Lb' to be in_line (reported by Ulrich Spoerlein).Kristaps Dzonsons2010-05-261-1/+25
| | | | | | | | | 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).
* LIBRARY can also occur in section 9.Kristaps Dzonsons2010-05-151-2/+2
| | | | | | 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.
* Documented EOS buffered spaces and added `]'.Kristaps Dzonsons2010-05-151-2/+10
|
* Backed out check for `Ex' manual sec (ok schwarze@, joerg@), in turn backing ↵Kristaps Dzonsons2010-05-141-1/+2
| | | | out check_msec() and deps.
* "Warn on unknown argument for .At and print it like [new] groff." (patch by ↵Kristaps Dzonsons2010-05-141-0/+6
| | | | | | | Joerg Sonnenberger, ed. Kristaps) Keep short-log of commits in index.sgml. Document compatibility with new/old groff in mdoc.7.
* Finish initial documentation of the Bl lists.Kristaps Dzonsons2010-05-141-0/+39
|
* Re-addition of cleaned-up list documentation in mdoc.7.Kristaps Dzonsons2010-05-141-54/+68
|
* Added documentation bits.Kristaps Dzonsons2010-05-141-0/+3
|
* Put the eos-checker into libmandoc.h.Kristaps Dzonsons2010-05-121-0/+6
| | | | Added bits in mdoc.7 and man.7 about EOS spacing.
* End of sentence, end of line for mdoc.7.Kristaps Dzonsons2010-05-121-144/+195
|
* mdoc_atosec -> mdoc_str2sec (consistent with str2 being different from a2).Kristaps Dzonsons2010-05-121-13/+13
| | | | | Changed ordering of sections (EXIT STATUS moved around), argued for by Ulrich Sporlein. Fixed mdoc_str2sec not to use weird structure.
* Adding initial mailing list section to homepage.Kristaps Dzonsons2010-05-081-1/+1
|
* Note that whitespace is really only the space character.Kristaps Dzonsons2010-05-081-1/+2
|
* Strip trailing, unescaped whitespace from free-form, non-literal lines (like ↵Kristaps Dzonsons2010-05-081-14/+4
| | | | groff).
* De-chunking of text removed from parsers. This is a significant change (and ↵Kristaps Dzonsons2010-05-071-4/+0
| | | | | | I don't really like it), but it's what groff does. Distinction of ARGS_PHRASE and ARGS_PPHRASE in backend (not yet used).
* As per Jason McIntyre's heartful urgings, do away with '.' separators ↵Kristaps Dzonsons2010-04-131-159/+2
| | | | | | between logical sections. Change email address to BSD.lv one (this is not an academic project...)
* Added some clarifying bits to mdoc.7 regarding GNU troff, mandoc, and ↵Kristaps Dzonsons2010-04-071-42/+54
| | | | 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).
* Allowing `Cd' to be in section 9 (noted by Joerg Sonnenberger).Kristaps Dzonsons2010-04-071-1/+1
|
* Breaking mdoc.7's multiline examples into sets of D1. A few errors found ↵Kristaps Dzonsons2010-04-071-128/+66
| | | | here and there.
generated by cgit (git 2.34.1) at 2024-11-14 18:57:41 +0000