mandoc/man.7 - diff

Return to man.7 CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/man.7 between version 1.144 and 1.149

version 1.144, 2019/07/09 03:46:59

version 1.149, 2023/10/07 21:27:56

Line 1

.\" $Id$

.\"

Line 97 but can be found in the alphabetical reference below.

.It Ic SH Ta section header (one line)

.It Ic SS Ta subsection header (one line)

.It Ic PP Ta start an undecorated paragraph (no arguments)

.It Ic RS , RE Ta reset the left margin: Op Ar width

.It Ic IP Ta indented paragraph: Op Ar head Op Ar width

.It Ic TP Ta tagged paragraph: Op Ar width

.It Ic PD Ta set vertical paragraph distance: Op Ar height

.It Ic EX , EE Ta display an example (no arguments)

.It Ic RS , RE Ta reset the left margin: Op Ar width

.It Ic in Ta additional indent: Op Ar width

.El

.Ss Physical markup

Line 127 Sets the volume for the footer for compatibility with

Line 128 Sets the volume for the footer for compatibility with

.At

releases.

The optional arguments specify which release it is from.

This macro is an extension that first appeared in

.Bx 4.3 .

.It Ic B

Text is rendered in bold face.

.It Ic BI

Line 160 This has no effect unless the tabulator positions were

Line 163 This has no effect unless the tabulator positions were

.Ic ta

request.

.It Ic EE

This is a non-standard Version 9

End an example block started with

.Ic EX .

This is a Version 9

.At

extension later adopted by GNU.

Line 170 it does the same as the

Line 175 it does the same as the

.Ic fi

request (switch to fill mode).

.It Ic EX

This is a non-standard Version 9

Begin a block to display an example.

This is a Version 9

.At

extension later adopted by GNU.

Line 232 A synonym for

Line 238 A synonym for

.It Ic ME

End a mailto block started with

.Ic MT .

This is a non-standard GNU extension.

This is a GNU extension.

.It Ic MT

Begin a mailto block.

This is a non-standard GNU extension.

This is a GNU extension.

It has the following syntax:

.Bd -unfilled -offset indent

.Pf . Ic MT Ar address

Line 244 link description to be shown

Line 250 link description to be shown

.Ed

.It Ic OP

Optional command-line argument.

This is a non-standard GNU extension.

This is a rarely used DWB extension.

It has the following syntax:

.Pp

.D1 Pf . Ic OP Ar key Op Ar value

Line 255 is usually a command-line flag and

Line 261 is usually a command-line flag and

.Ar value

its argument.

.It Ic P

A synonym for

This synonym for

.Ic PP .

.Ic PP

is an

.At III

extension later adopted by

.Bx 4.3 .

.It Ic PD

Specify the vertical space to be inserted before each new paragraph.

.br

Line 343 See also

Line 353 See also

.It Ic SB

Text is rendered in small size (one point smaller than the default font)

bold face.

This macro is an extension that probably first appeared in SunOS 4.0

and was later adopted by GNU and by

.Bx 4.4 .

.It Ic SH

Begin a section.

The scope of a section is only closed by another section or the end of

Line 364 Begin a synopsis block with the following syntax:

Line 377 Begin a synopsis block with the following syntax:

.Pf . Ic YS

.Ed

.Pp

This is a non-standard GNU extension

This is a GNU extension and rarely used even in GNU manual pages.

and very rarely used even in GNU manual pages.

Formatting is similar to

.Ic IP .

.It Ic TH

Line 428 unspecified, the saved or default width is used.

Line 440 unspecified, the saved or default width is used.

.Ic TP ,

except that no vertical spacing is inserted before the paragraph.

This is a non-standard GNU extension

This is a GNU extension and rarely used even in GNU manual pages.

and very rarely used even in GNU manual pages.

.It Ic UC

Sets the volume for the footer for compatibility with man pages from

.Bx

releases.

The optional first argument specifies which release it is from.

This macro is an extension that first appeared in

.Bx 3 .

.It Ic UE

End a uniform resource identifier block started with

.Ic UR .

This is a non-standard GNU extension.

This is a GNU extension.

.It Ic UR

Begin a uniform resource identifier block.

This is a non-standard GNU extension.

This is a GNU extension.

It has the following syntax:

.Bd -unfilled -offset indent

.Pf . Ic UR Ar uri

Line 451 link description to be shown

Line 464 link description to be shown

.It Ic YS

End a synopsis block started with

.Ic SY .

This is a non-standard GNU extension.

This is a GNU extension.

.It Ic in

Indent relative to the current indentation:

.Pp

Line 505 The syntax is as follows:

Line 518 The syntax is as follows:

.It Ic I Ta n Ta next-line Ta \&

.It Ic IB Ta n Ta current Ta \&

.It Ic IR Ta n Ta current Ta \&

.It Ic OP Ta >=1 Ta current Ta GNU

.It Ic OP Ta >=1 Ta current Ta DWB

.It Ic PD Ta 1 Ta current Ta \&

.It Ic RB Ta n Ta current Ta \&

.It Ic RI Ta n Ta current Ta \&

Line 601 The

Line 614 The

language first appeared as a macro package for the roff typesetting

system in

.At v7 .

It was later rewritten by James Clark as a macro package for groff.

.Pp

Eric S. Raymond wrote the extended

.Nm

macros for groff in 2007.

The stand-alone implementation that is part of the

.Xr mandoc 1

utility written by Kristaps Dzonsons appeared in

utility first appeared in

.Ox 4.6 .

.Sh AUTHORS

This

.An -nosplit

.An Douglas McIlroy Aq Mt m.douglas.mcilroy@dartmouth.edu

designed and implemented the original version of these macros,

wrote the original version of this manual page,

and was the first to use them when he edited volume 1 of the

.At v7

manual pages.

.Pp

.An James Clark

later rewrote the macros for groff.

.An Eric S. Raymond Aq Mt esr@thyrsus.com

and

.An Werner Lemberg Aq Mt wl@gnu.org

added the extended

.Nm

reference was written by

macros to groff in 2007.

.Pp

The

.Xr mandoc 1

program and this

.Nm

reference were written by

.An Kristaps Dzonsons Aq Mt kristaps@bsd.lv .

CVSweb