mandoc/mdoc.7 - diff

Return to mdoc.7 CVS log

Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/mdoc.7 between version 1.67 and 1.72

version 1.67, 2009/10/22 10:33:28

version 1.72, 2009/11/02 06:22:45

Line 212 In free-form mode, quotes are regarded as opaque text.

.Ss Dates

There are several macros in

.Nm

that require a date argument. The

that require a date argument. The canonical form for dates is the

.Em canonical form

American format:

for dates is the American format:

.Pp

.D1 Cm Month Day , Year

.Pp

Line 226 value is the full month name. The

Line 225 value is the full month name. The

.Cm Year

value is the full four-digit year.

.Pp

The

Reduced form dates are broken-down canonical form dates:

.Em non-canonical form

is the same as the canonical form, but without the comma between the

.Cm Day

and

.Cm Year

field.

.Pp

Lastly,

.D1 Cm Month , Year

.Em reduced form

.D1 Cm Year

dates range from only a

.Cm Year

to the full canonical or non-canonical form.

.Pp

Some examples of valid dates follow:

.Pp

.D1 "May, 2009" Pq reduced form

.D1 "2009" Pq reduced form

.D1 "May 20, 2009" Pq canonical form

.D1 "May 20 2009" Pq non-canonical form

.Ss Scaling Widths

Many macros support scaled widths for their arguments, such as

Line 611 then the macro accepts an arbitrary number of argument

Line 600 then the macro accepts an arbitrary number of argument

.It Sx \&%N Ta \&No Ta \&No Ta >0

.It Sx \&%O Ta \&No Ta \&No Ta >0

.It Sx \&%P Ta \&No Ta \&No Ta >0

.It Sx \&%Q Ta \&No Ta \&No Ta >0

.It Sx \&%R Ta \&No Ta \&No Ta >0

.It Sx \&%T Ta \&No Ta \&No Ta >0

.It Sx \&%U Ta \&No Ta \&No Ta >0

.It Sx \&%V Ta \&No Ta \&No Ta >0

.It Sx \&Ad Ta Yes Ta Yes Ta n

.It Sx \&An Ta Yes Ta Yes Ta n

Line 708 this macro is not implemented in

Line 699 this macro is not implemented in

.Ss \&%D

Publication date of an

.Sx \&Rs

block. This should follow the reduced syntax for

block. This should follow the reduced or canonical form syntax

described in

.Sx Dates .

Canonical or non-canonical form is not necessary since publications are

often referenced only by year, or month and year.

.Ss \&%I

Publisher or issuer name of an

Line 756 Article title of an

Line 746 Article title of an

block. This macro may also be used in a non-bibliographical context

when referring to article titles.

.Ss \&%U

URI of reference document.

.Ss \&%V

Volume number of an

.Sx \&Rs

Line 1147 The

Line 1140 The

field may be either

.Ar $\&Mdocdate$ ,

which signifies the current manual revision date dictated by

.Xr cvs 1

.Xr cvs 1 ,

or instead a valid canonical date as specified by

.Sx Dates .

If a date does not conform, the current date is used instead.

.Pp

Examples:

.Bd -literal -offset indent

Line 1339 See also

Line 1333 See also

.Sx \&Er .

.Ss \&Dx

Format the DragonFlyBSD version provided as an argument, or a default

Format the DragonFly BSD version provided as an argument, or a default

value if no argument is provided.

.Pp

Examples:

Line 1446 and

Line 1440 and

.Ss \&Lb

.Ss \&Li

.Ss \&Lk

Format a hyperlink. The calling syntax is as follows:

.Pp

.D1 \. Ns Sx \&Lk Cm uri Op Cm name

.Pp

Examples:

.Bd -literal -offset indent

\&.Lk http://bsd.lv "The BSD.lv Project"

\&.Lk http://bsd.lv

.Ed

.Pp