aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/mandoc_char.7
Commit message (Collapse)AuthorAgeFilesLines
* Even though we strongly discourage escaping hyphens in manual pagesIngo Schwarze2018-08-081-2/+2
| | | | | in general, when introducing the *typographic* term "hyphen", actually display a real hyphen in output modes supporting it.
* Reorder the text in the "Dashes and Hyphens" subsection to keep theIngo Schwarze2018-08-081-25/+25
| | | | | | simplest and most important instructions together and at the beginning. No text change. Suggested by jmc@.
* Clarify the confusing "(text)" annotation in the character lists.Ingo Schwarze2018-08-081-17/+18
| | | | | | | | | | In some cases, it meant "render as an ASCII character in output modes that have a notion of codepoints" (e.g. UTF-8, HTML); in other cases, "render in the text font in output modes that also provide a special font for mathematical symbols" (e.g. PostScript, PDF). Also explicitly annotate the escape sequences that use a special font if available. OK bentley@
* After years of deliberation, finally provide a clear recommendationIngo Schwarze2018-08-081-16/+21
| | | | | | | | for hyphens and minus signs in manual pages. Since there is consensus that a typographically perfect solution is impossible, let's KISS - just write "-", don't bother with "\-", all currently relevant manual page formatters can handle "-" reasonably. OK jmc@ bentley@
* Soften the language discouraging special character escape sequences.Ingo Schwarze2018-03-151-8/+22
| | | | | | | After i improved their ASCII renderings in groff and mandoc some time ago, mathematical symbols can now be used in specialised mathematical manual pages like libm and some X libraries. Tweaks and OK jmc@.
* add the \(ru (0.5m baseline ruler) character escape sequence,Ingo Schwarze2017-06-141-2/+3
| | | | abused by mail/nmh; groff_char(7) confirms that this really exists
* add about 15 missing character escape sequences found in groff_char(7);Ingo Schwarze2017-06-021-6/+26
| | | | triggered by multimedia/mkvtoolnix mkvmerge(1) using \(S2
* Delete the -T xhtml command line option.Ingo Schwarze2017-05-171-5/+3
| | | | | It has been obsolete for more than two years. Use -T html.
* document hyphenationIngo Schwarze2017-02-051-2/+26
|
* Recommend an unambiguous escape for minus signs instead of \-.Ingo Schwarze2015-09-021-7/+7
| | | | | | | | | | | | | | | | | | | | | | Historically, \- was used in troff for three cases: flags/pathnames, en dashes, and minus signs. mandoc_char(7) currently recommends it for minus signs, recommends \(en for en dashes, and doesn't mention flags/pathnames. In the old days, nroff rendered \- as ASCII '-', and troff rendered it as en dash/minus (which were visually indistinguishable). In Unicode, en dashes and minus signs are semantically distinct and encoded differently (U+2013 for en dash, U+2212 for minus), and often rendered differently too. Meanwhile ASCII '-' has been renamed "hyphen-minus" and fonts typically render it closest to a hyphen, not a minus. There is very little consistency across roff implementations and output formats for what Unicode character \- corresponds to. So at least for minus signs, change the recommendation to the unambiguous \(mi escape. from bentley@, ok jmc@ (after reams of discussion)
* Escape punctuation characters that have a different meaning in -Tpdf.Ingo Schwarze2015-03-301-42/+38
| | | | | | | | ~, `, and ' get translated to non-ASCII characters by most troff implementations when generating PostScript/PDF output. When the original ASCII character is meant, it needs to be manually escaped. Patch from bentley@.
* oops, forgot to apply the actual patch...Ingo Schwarze2015-03-271-1/+23
|
* Document that certain stand-alone accents need escaping in rare cases toIngo Schwarze2015-03-271-3/+3
| | | | | prevent them from being converted to Unicode replacements in PDF output. Issue found by bentley@, OK jmc@ bentley@.
* change spelling of centre to center: consistent with other man pagesIngo Schwarze2015-01-201-3/+3
| | | | and the name of the syntax elements being described; from tedu@
* correct -Tutf8 and -Thtml rendering of \(~=Ingo Schwarze2014-12-161-7/+7
| | | | | and change the name of \(-~ to \(|= to agree with groff; difference found by Carsten dot Kunze at arcor dot de
* correct some character names to match groff;Ingo Schwarze2014-12-151-10/+10
| | | | reported by Carsten dot Kunze at arcor dot de
* Rework the documentation of Spaces, using the Ossanna/Kernighan/RitterIngo Schwarze2013-12-261-22/+22
| | | | | | | | | | | | | | | | Heirloom Nroff/Troff User's Manual at the authoritative reference. Part of our text was outright wrong. Also, refrain from advertising the paddable non-breaking space `\~' in the DESCRIPTION, for three reasons: For nroff mode, -Tascii, and fixed width fonts in general, it makes no difference, so keep the discussion simple. Compared to `\ ', '\~' is of questionable portability. And if you want to keep words together, it is also more usual that you don't want padding to intervene either. Finally, drop the `\c' escape sequence (interrupt text processing) which is not a special character but an input processing instruction akin to the \<newline> escape sequence.
* Document the alternative syntax \C'uXXXX' for Unicode characters.Ingo Schwarze2013-12-221-5/+5
| | | | Forgotten when committing mandoc.c rev. 1.70.
* clarify that \[uXXXX] wants uppercase hex digitsIngo Schwarze2013-11-101-3/+8
|
* For citing the names and email addresses of authors,Ingo Schwarze2013-07-131-4/+3
| | | | | | | consistently use the style ".An name Aq Mt email". Triggered by a question from Jan Stary <hans at stare dot cz>, ok jmc@.
* - (mdoc.7) fix Xr to selfIngo Schwarze2013-04-281-3/+3
| | | | | - double word fix from jmc@
* Fix whitespace in manuals.Kristaps Dzonsons2011-11-231-3/+3
|
* Add lots of information about special characters that's actually neededIngo Schwarze2011-11-141-42/+177
| | | | | | in practice, and discourage using fancy characters in manuals. Text about "Dashes and Hyphens" by jmc@. Feedback and ok jmc@, grudgingly ok kristaps@.
* Order -column lists to have the arguments follow `-column'. From aKristaps Dzonsons2011-08-301-19/+19
| | | | patch by Jason McIntyre.
* Remove unnecessary `Pp'/`-compat' combination for column lists.Kristaps Dzonsons2011-08-301-4/+3
| | | | Directly from a patch by Jason McIntyre.
* Replace the old `An'/`Aq' AUTHORS note with `An'/`Mt'.Kristaps Dzonsons2011-08-181-3/+4
|
* Add support for 1/2, 1/4, and 3/4 (needed by eqn).Kristaps Dzonsons2011-07-221-2/+5
|
* Support groff's escape for Unicode input. SeeKristaps Dzonsons2011-05-151-2/+16
| | | | | | http://mdocml.bsd.lv/archives/tech/0368.html For the time being, we just throw it away.
* Document the fact that \N'' accepts only printable characters.Kristaps Dzonsons2011-05-011-2/+5
|
* Add \*(Ai (ANSI) and \*(Px (POSIX) predefined strings, which are part ofKristaps Dzonsons2011-04-201-4/+11
| | | | | | groff's tmac.doc package. Originally noted by Matthew Dempsky. Feedback by Jason McIntyre, joerg@, and schwarze@. Also add some documentation about predefined strings, tweaked by schwarze@.
* Clean up the COMPATIBILITY section;Ingo Schwarze2011-02-091-24/+32
| | | | | | | | | heavily based on a patch from kristaps@ with some tweaks by me. - Also talk about -Tps and -Tpdf. - Use the same list style as in the other mandoc manuals. - Replace a few macros by ones better suited. - Some improvements of wording. ok jmc@ kristaps@
* Implement the \N'number' (numbered character) roff escape sequence.Ingo Schwarze2011-01-301-2/+17
| | | | | | | Don't use it in new manuals, it is inherently non-portable, but we need it for backward-compatibility with existing manuals, for example in Xenocara driver pages. ok kristaps@ jmc@ and tested by Matthieu Herrb (matthieu at openbsd dot org)
* Remove a left-over ".Xr groff 1"; patch from jmc@.Ingo Schwarze2010-10-291-4/+3
|
* Fix quoting of bar: \*(Ba mapping "|" is dumb, dumb, dumb (thanks groff).Kristaps Dzonsons2010-05-121-3/+3
|
* Noted \*(Ba side effects.Kristaps Dzonsons2010-05-091-1/+12
|
* Fixed ugly formatting of mandoc_char.7 in groff (-column widths were using ↵Kristaps Dzonsons2010-05-091-4/+4
| | | | an escape, which groff understands but mandoc doesn't).
* As per Jason McIntyre's heartful urgings, do away with '.' separators ↵Kristaps Dzonsons2010-04-131-41/+4
| | | | | | between logical sections. Change email address to BSD.lv one (this is not an academic project...)
* Make mathematical symbols have a longer first-column width (pointed out by ↵Kristaps Dzonsons2010-04-051-3/+3
| | | | Joerg Sonnenberger).
* Escape TH -> Th (noticed by Joerg Sonnenberger).Kristaps Dzonsons2010-03-301-21/+2
| | | | Moved pod2man escapes into man.3 (they're not part of -man or -mdoc, technically).
* Added stupid pod2man reserved strings.Kristaps Dzonsons2010-03-231-2/+21
|
* Removed STANDARDS in mandoc_char(7), as they're no longer relevant (the ↵Kristaps Dzonsons2010-03-221-15/+2
| | | | manual deals with input characters, not output formats).
* mandoc_char(7) sync with OpenBSD version.Kristaps Dzonsons2010-01-071-3/+3
|
* Fixed -column widths to be string literals (as per mdoc.samples: surprise!). ↵Kristaps Dzonsons2010-01-051-27/+27
| | | | | | | (Jason McIntyre, Ingo Schwarze) Remove trailing whitespace. (Jason McIntyre, Ingo Schwarze). Remove reference to `\\', which is a groff strangeism. (Jason McIntyre, Ingo Schwarze).
* More clarification in manuals. Added per-OUTPUT section in mandoc.1.Kristaps Dzonsons2009-11-161-21/+2
|
* Fixed \c support for all input and output modes (documented in mandoc_char.7).Kristaps Dzonsons2009-11-121-2/+3
|
* Fixed mandoc_char lists to have -column before other arguments.Kristaps Dzonsons2009-10-171-17/+17
|
* Fix in mandoc.1 and mandoc_char.7 syntax (submitted Joerg Sonnenberger).Kristaps Dzonsons2009-10-151-7/+39
| | | | Added note on character format per output type.
* Set field widths n -> m.Kristaps Dzonsons2009-10-071-20/+20
|
* Many more macros added to -Thtml.Kristaps Dzonsons2009-09-241-364/+387
| | | | Minor space issues fixed in -Tascii.
* All special characters sync'd with groff, both -Thtml and -Tascii.Kristaps Dzonsons2009-09-231-55/+81
| | | | Re-added text links to index.sgml (just for show).
generated by cgit v1.2.3-56-ge451 (git 2.39.0) at 2024-05-28 23:09:35 +0000