summaryrefslogtreecommitdiffstats
path: root/share/man/man7/mdoc.7 (follow)
Commit message (Collapse)AuthorAgeFilesLines
* While answering a question asked by espie@, i noticed that .Fd is notschwarze2013-11-021-9/+30
| | | | | completely obsolete, but still somewhat useful for listing preprocessor directives, in particular in the SYNOPSIS.
* Fix an .Lb example in two respects:schwarze2013-10-061-3/+3
| | | | | As noticed by Sascha Wildner (DragonFly), .Lb wants a "lib" prefix. And mdoc(3) was merged into mandoc(3) long ago.
* Beagle has been replaced by armv7.patrick2013-09-041-3/+3
|
* Use text production macros to document themselves.schwarze2013-08-141-7/+17
| | | | | | 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@.
* For citing the names and email addresses of authors,schwarze2013-07-131-5/+5
| | | | | | | consistently use the style ".An name Aq Mt email". Triggered by a question from Jan Stary <hans at stare dot cz>, ok jmc@.
* Add .St values for POSIX 1003.1d, 1003.1j, and 1003.1qguenther2013-06-171-6/+12
| | | | | | | Tweak descriptions of the other POSIX 1003.1<letter> standards Sort a few others into their proper places Discussed with schwarze@ at t2k13
* - (mdoc.7) fix Xr to selfjmc2013-04-271-4/+4
| | | | - double word fix
* bits for octeon (will format as OCTEON in Dt);jmc2013-03-261-1/+2
|
* no more palm;jmc2013-03-261-3/+2
|
* 1) Remove documentation of the groff-1.15 compatibility quirkschwarze2012-08-291-12/+6
| | | | | | | | | | | of suppressing spacing before a third .Xr argument because that quirk was removed in mdoc_macro.c rev. 1.72. 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@.
* no more mac68k; ok schwarzejmc2012-06-201-2/+1
|
* When i moved some low-level stuff from mdoc(7) and man(7)schwarze2012-06-201-11/+11
| | | | | | | 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@
* Support .St -isoC-2011 to refer to ISO C11.schwarze2012-01-031-2/+4
| | | | | From Ulrich Spoerlein, tweaked by kristaps@. Werner Lemberg added the same .St argument to groff today.
* Clean up the description of .Dt:schwarze2011-11-011-38/+36
| | | | | | | | - 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. - Update the list of architectures for OpenBSD. Using lots of input from jmc@.
* even though .Bl is not callable, groff complains when it appearsschwarze2011-09-271-3/+3
| | | | | unescaped on a macro line, so lets just escape it; noticed by jmc@
* Reorganize part of the content:schwarze2011-09-261-645/+445
| | | | | | | | | | | | | 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@
* Replace the .Fl examples by others exhibiting the same features,schwarze2011-09-261-8/+8
| | | | | | 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@.
* sync to version 1.11.7 from kristaps@schwarze2011-09-181-6/+12
| | | | | | | | main new feature: support the roff(7) .tr request plus various bugfixes and some refactoring regressions are so minor that it's better to get this in and fix them in the tree
* sync to mandoc 1.11.5:schwarze2011-09-181-126/+167
| | | | | | | document eqn(7) and many other improvements from kristaps@ no objection from deraadt@ against adding an eqn.7 page
* Add a MACRO OVERVIEW, listing all macros ordered by purpose,schwarze2011-09-171-2/+126
| | | | | | | 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@
* after some thought, i think it unlikely that we will need to specifyjmc2011-09-161-4/+4
| | | | | | | | | | a revision number for ISO 8601; in addition, the revision number makes the text unwieldy when discussing the standard in a casual manner. therefore change the macro from -8601-4 to simply -8601, which will output "ISO 8601". i'll get kristaps or ingo to make the change upstream to mandoc. discussed with/ok millert
* add an St macro for ISO 8601:2004;jmc2011-09-091-2/+4
| | | | ok kristaps (who will update the mandoc repo)
* in column lists, enforce the following ordering:jmc2011-08-301-3/+3
| | | | | | | | | .Bl -column header1 header2 ... <Bl flags> mixing things up confuses mandoc, and adding flags in can screw up the list. this hopefully just makes things a bit safer (and more consistent). (one more bit of work left and all column lists should format how we want)
* remove some pointless Pp/-compact combinations; either ingo or kristapsjmc2011-08-301-14/+8
| | | | will update mandoc repo
* More information about lots of macros, many new examples, and various fixes.schwarze2011-08-161-53/+166
| | | | ok kristaps@
* Add small chunks of new text and better examples written from scratch,schwarze2011-08-031-28/+65
| | | | | | | filling gaps found by checking the MANUAL DOMAIN chapter in mdoc.samples(7). While here, fix lots of minor issues. feedback and ok jmc@; tree is locked, but ok to commit this one from deraadt@
* The term "reserved characters" is too broad, so narrow it downschwarze2011-08-021-47/+92
| | | | | | | | 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@
* Add some new text written from scratch after checking whether anythingschwarze2011-08-011-6/+40
| | | | | | | | | | | 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@
* clarify .Ex and .Rv documentation; from kristaps@, tweaked a bitschwarze2011-07-311-12/+22
|
* AT&T recently released a new version of UNIX (System III).schwarze2011-07-241-2/+5
| | | | This will soon be needed for the HISTORY of string(3).
* improve documentation of .Bl -column .It Taschwarze2011-07-151-24/+42
| | | | using feedback from kristaps@, ok jmc@
* be more specific about .Dv, .Er, and .Ev; from kristaps@schwarze2011-07-151-6/+20
|
* no more mvmeppc;jmc2011-07-071-3/+2
|
* bring in lots of improvements from kristaps@;schwarze2011-06-071-66/+92
| | | | | jmc@ agrees that it's easiest to first commit it, then tweak it in the tree
* fix a formatting error, as reported by Mikolaj Kucharski;jmc2011-06-051-3/+3
| | | | ingo will sync upstream
* remove a sentence which isn;t true; ingo will sync upstreamjmc2011-05-161-4/+2
| | | | ok schwarze
* The semantics of .Bk was described incorrectlyschwarze2011-04-171-4/+5
| | | | | | for the case of multiple sibling macros on a single input line. Issue found investigating a question from sobrado@. "I like this diff" kristaps@
* Clean up date handling,schwarze2011-03-071-43/+39
| | | | | | | | | | | | 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@
* Between groff-1.15 and groff-1.20.1, the .Ns macro was changed to noschwarze2011-02-071-5/+7
| | | | | | | longer suppress spacing when used at the beginning of an input line, and mandoc now follows the same behaviour as new groff. Thus, sweep the tree and remove useless .Ns. Most places found by jmc@; ok jmc@ kristaps@.
* If .Ns is specified on its own line, ignore it, like groff does;schwarze2011-02-061-3/+5
| | | | from kristaps@.
* As noticed by deraadt@, it goes without saying that text filesschwarze2011-01-251-5/+2
| | | | | | on a UNIX system use UNIX conventions, and UNIX tools working on them expect that. ok jmc@
* Lots of in-line macros require arguments but were not marked as such.schwarze2011-01-221-11/+11
| | | | Check prompted by kristaps@.
* If the first character of a free-form text input line is whitespace,schwarze2011-01-161-2/+5
| | | | | then it will start a new output line; from kristaps@.
* Add and install tbl(7);schwarze2011-01-091-2/+5
| | | | written by kristaps@, looked over by jmc@.
* Sync to bsd.lv:schwarze2011-01-091-94/+99
| | | | | * one additional pair of .Sx cross references * prefer .Dl over .D1 for code examples
* minor tweaks:schwarze2010-12-221-3/+16
| | | | | | | - improve .Bl wording (from jmc@) - document .Pa default (from kristaps@) - fix formatting of one COMPATIBILITY note: move "and" out of .Sx ok jmc@, kristaps@
* Be more specific about what .Xo can be used for.schwarze2010-11-301-5/+9
| | | | jmc@ calls this change "sufficient"
* Define the terms "callable" and "parsed" with more precision.schwarze2010-11-281-13/+19
| | | | | | Be more specific about what "historic groff" refers to. Explicitely mention the nine argument limit below COMPATIBILITY. feedback and ok jmc@
* Referring to terms explained in other manuals, always use .Xr.schwarze2010-10-291-4/+4
| | | | | | Otherwise, hyperlinks can't be produced and people will likely miss the additional information available. Requested by deraadt@.
* When mentioning a function documented elsewhere, .Xr is often better than .Fn.schwarze2010-10-241-2/+5
| | | | Prodded by guenther@, ok jmc@.
Copyright © 1996 – 2023 Jason A. Donenfeld. All Rights Reverse Engineered.