summaryrefslogtreecommitdiffstats
path: root/mdoc.3
Commit message (Collapse)AuthorAgeFilesLines
* Correctly labelled command-line as `Dl'.Kristaps Dzonsons2010-12-171-1/+1
|
* Cleaned up library manuals: removed old escapes, added EXAMPLES, strippedKristaps Dzonsons2010-10-101-29/+7
| | | | out some superfluous stuff.
* Implement a simple, consistent user interface for error handling.Ingo Schwarze2010-08-201-6/+1
| | | | | | | | | | | | | | | | | We now have sufficient practical experience to know what we want, so this is intended to be final: - provide -Wlevel (warning, error or fatal) to select what you care about - provide -Wstop to stop after parsing a file with warnings you care about - provide consistent exit status codes for those warnings you care about - fully document what warnings, errors and fatal errors mean - remove all other cruft from the user interface, less is more: - remove all -f knobs along with the whole -f option - remove the old -Werror because calling warnings "fatal" is silly - always finish parsing each file, unless fatal errors prevent that This commit also includes a couple of related simplifications behind the scenes regarding error handling. Feedback and OK kristaps@; Joerg Sonnenberger (NetBSD) and Sascha Wildner (DragonFly BSD) agree with the general direction.
* Re-constitution of `ds' symbol processing. First, push theKristaps Dzonsons2010-07-071-1/+0
| | | | | | | | | roff_getstr() family of functions into roff.c with the "first_string" directly in struct roff. Second, pre-process each line for reserved words in libroff, splicing and re-running a line if it has one (this allows defined symbols to be macros). Remove term.c's invocation of the roff_getstrn() function. Removed function documentation in roff.3 and added roff.7 `ds' documentation.
* 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@
* "Tweak previous": "badly nested" becomes badly-nested, some typosKristaps Dzonsons2010-07-011-17/+24
| | | | corrected, and a bit of clarity for my own sake.
* Support for badly nested blocks, written around the time ofIngo Schwarze2010-06-291-4/+67
| | | | | | | | | | | | | | | | | | | | | | | | | the Rostock mandoc hackathon and tested and polished since, supporting constructs like: .Ao Bo Ac Bc (exp breaking exp) .Aq Bo eol Bc (imp breaking exp) .Ao Bq Ac eol (exp breaking imp) .Ao Bo So Bc Ac Sc (double break, inner before outer) .Ao Bo So Ac Bc Sc (double break, outer before inner) .Ao Bo Ac So Bc Sc (broken breaker) .Ao Bo So Bc Do Ac Sc Dc (broken double breaker) There are still two known issues which are tricky: 1) Breaking two identical explicit blocks (Ao Bo Bo Ac or Aq Bo Bo eol) fails outright, triggering a bogus syntax error. 2) Breaking a block by two identical explicit blocks (Ao Ao Bo Ac Ac Bc or Ao Ao Bq Ac Ac eol) still has a minor rendering error left: "<ao1 <ao2 [bo ac2> ac1> bc]>" should not have the final ">". We can fix these later in the tree, let's not grow this diff too large. "get it in" kristaps@
* Following clue-stick applied by schwarze@, back out const-ness of regsetKristaps Dzonsons2010-06-271-2/+4
| | | | | | | | | passed in to libmdoc and libman. Fix mdoc.3 and man.3 EXAMPLE sections to include regset. Add MDOC_SYNPRETTY flag cueing front-end to nicely format certain values as if SEC_SYNOPSIS were the current section.
* Downstream maintainers: this removes UGLY! I don't want divergingKristaps Dzonsons2010-06-271-2/+6
| | | | | | | | | functionality and UGLY works quite well thanks to schwarze@'s careful attention. This also backs out function-prototype changes for struct regset, instead stuffing a pointer to the regset directly into struct mdoc/man/roff.
* Churn-ish check-in getting mdoc_parseln() and man_parseln() to accept aKristaps Dzonsons2010-06-261-1/+7
| | | | const struct regset pointer. No functionality.
* Migrate `Bl -column' phrases to be MDOC_BODY instead of MDOC_HEAD. ThisKristaps Dzonsons2010-05-301-5/+5
| | | | | | | | | | will make it easy for re-entrant parsing of `Ta' macros to fit in with standard closure rules. Added some more regressions for `Bl -column'. Note that one should fail, as documented in the TODO file. Recorded change of AST BNF in mdoc.3.
* Added roff.3, which documents the roff parser interface.Kristaps Dzonsons2010-05-251-3/+2
| | | | | | | | | | | Small fix in mdoc.3 and man.3 pointing to old mdoc_cb and man_cb. Fix in Makefile adding mandoc.h to HEADS. Collapsed all HTML files into HTMLS variable (too confusing otherwise). Removed "htmls" command from Makefile (only I used it and it's just taking up space).
* Clean-up: added `Nm mdoc' to mdoc.3.Kristaps Dzonsons2010-05-251-0/+1
| | | | | | Clean-up: new-sentence, new-line for man.3. Clean-up: alpha-ordered man.3 `Nm' sections and prototypes.
* Clean-up: new-sentence, new-line for mdoc.3.Kristaps Dzonsons2010-05-251-105/+59
| | | | | | | Clean-up: removed CAVEATS section (this should be either in the TODO file or in mdoc.7 documenting mandoc incompatibilities). Clean-up: alpha-ordered `Nm' and section headers.
* Removed offsets from most parts (no reason for indentation).Kristaps Dzonsons2010-02-171-18/+18
| | | | | Using POSIX2008 idioms for examples (thanks Joerg Sonnenberger). Removed references to fgetln().
* Fix white-space issues found by mandoc's better white-space finder.Kristaps Dzonsons2010-01-071-1/+1
| | | | Fixed bogus `\\' escapes in some manuals.
* Fixed mandoc.1 examples (new -Thtml options).Kristaps Dzonsons2009-10-031-1/+1
| | | | | Fixed manuals to use `In', not `Fd'. Moved buf* functions into html.c.
* Made tree/term/out() functions return void.Kristaps Dzonsons2009-09-161-1/+1
| | | | Put err() functions back into front-ends (no use making it needlessly complex).
* Removed trailing whitespace in manuals.Kristaps Dzonsons2009-07-201-32/+32
|
* Removed some finished FIXMEs in mdoc.3.Kristaps Dzonsons2009-07-191-8/+0
|
* Fixed man.3 mdoc.3 const-nesses.Kristaps Dzonsons2009-07-051-3/+3
|
* Fixed email address in manual AUTHOR reference.Kristaps Dzonsons2009-06-111-1/+1
| | | | | | Set max right margin to 80 columns (schwarze@openbsd.org). Fixed centre-field heading position (schwarze@openbsd.org). Also fixed -Tman centre-field.
* Fixed license email address.Kristaps Dzonsons2009-06-101-1/+1
|
* Using proper license template (const).Kristaps Dzonsons2009-04-121-12/+10
|
* Manual .Dt fields CAPITALISED.Kristaps Dzonsons2009-04-121-1/+1
| | | | | | | | 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.
* General clean-ups.Kristaps Dzonsons2009-03-311-2/+3
|
* Added some new manuals (mdoc.3 mandoc_char.7).Kristaps Dzonsons2009-03-271-12/+3
| | | | Support for .br in libman.
* All macro-invocations, for consistency, begin with `.' in documentation.Kristaps Dzonsons2009-03-261-7/+7
| | | | | Fixed \\ -> \e in manual documentation. All preliminary -man macros in place.
* More manual documentation fixed/improved.Kristaps Dzonsons2009-03-231-4/+7
|
* More documentation clarification.Kristaps Dzonsons2009-03-221-0/+3
|
* Fixes to dynamic addition of Bl width.Kristaps Dzonsons2009-03-211-0/+20
|
* Support for `Bd' of all types (see mdoc.7 for newline/tab rules).VERSION.1.6.2Kristaps Dzonsons2009-03-201-8/+21
| | | | | Renamed term.c and terminal.c functions to be term_. Some bugfixes to lists.
* Changed e-mail address to @openbsd.Kristaps Dzonsons2009-03-161-2/+2
| | | | Cleaned up manual-page documentation.
* Fixed mdoc_phrase escape handling.Kristaps Dzonsons2009-03-161-1/+4
| | | | | | | | | | | 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.
* mdoc.3 refers to local mdoc.7.Kristaps Dzonsons2009-03-141-168/+31
| | | | mdoc.7 includes its compatibility with system-dependent roff installations.
* Made syste-name macros callable (At, Bsx, etc.).Kristaps Dzonsons2009-03-121-6/+16
|
* Added -nested (doesn't do anything).Kristaps Dzonsons2009-03-121-0/+19
| | | | | | Added .%C. .Cd is now callable. Added .Rv -std.
* NetBSD '.[[:whitespace:]]*' properly handled.Kristaps Dzonsons2009-03-121-44/+39
| | | | mdoc.3 indicates compatibilities and bugs.
* Character-encoding stuff documented, expanded.Kristaps Dzonsons2009-02-271-0/+5
|
* More character-encoding.Kristaps Dzonsons2009-02-271-2/+39
|
* *** empty log message ***Kristaps Dzonsons2009-02-251-1/+4
|
* Character-encoding checked for all text (arguments/values).Kristaps Dzonsons2009-02-241-1/+18
|
* Adding revamped webpage.Kristaps Dzonsons2009-02-231-5/+14
|
* More in-file documentation and Linux-isation.Kristaps Dzonsons2009-02-231-13/+13
| | | | Moved mdoc_macros table definition into macro.c, where it belongs.
* More documentation in place.Kristaps Dzonsons2009-02-231-3/+3
|
* Considerable mdoc.3 documentation.Kristaps Dzonsons2009-02-231-19/+181
| | | | Added a few more escapes and macros.
* More documentation/installation fixes.Kristaps Dzonsons2009-01-201-0/+10
|
* More correct validation.Kristaps Dzonsons2009-01-191-15/+44
| | | | Elision of prologue macros from main tree.
* Documentation, more validations, cleaned up actions, added Nm action.Kristaps Dzonsons2009-01-171-0/+10
|
* Initial separation of tree/mdocml.1.Kristaps Dzonsons2009-01-161-18/+105
| | | | | Finished mdoc.3. Broken build: mdocml.c.
generated by cgit (git 2.34.1) at 2024-11-14 16:55:37 +0000