version 1.69, 2009/10/24 05:52:13 |
version 1.72, 2009/11/02 06:22:45 |
Line 212 In free-form mode, quotes are regarded as opaque text. |
|
Line 212 In free-form mode, quotes are regarded as opaque text. |
|
.Ss Dates |
.Ss Dates |
There are several macros in |
There are several macros in |
.Nm |
.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 |
.Pp |
.D1 Cm Month Day , Year |
.D1 Cm Month Day , Year |
.Pp |
.Pp |
Line 226 value is the full month name. The |
|
Line 225 value is the full month name. The |
|
.Cm Year |
.Cm Year |
value is the full four-digit year. |
value is the full four-digit year. |
.Pp |
.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 |
.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 |
.Pp |
Some examples of valid dates follow: |
Some examples of valid dates follow: |
.Pp |
.Pp |
.D1 "May, 2009" Pq reduced form |
.D1 "May, 2009" Pq reduced form |
.D1 "2009" Pq reduced form |
.D1 "2009" Pq reduced form |
.D1 "May 20, 2009" Pq canonical form |
.D1 "May 20, 2009" Pq canonical form |
.D1 "May 20 2009" Pq non-canonical form |
|
. |
. |
.Ss Scaling Widths |
.Ss Scaling Widths |
Many macros support scaled widths for their arguments, such as |
Many macros support scaled widths for their arguments, such as |
Line 710 this macro is not implemented in |
|
Line 699 this macro is not implemented in |
|
.Ss \&%D |
.Ss \&%D |
Publication date of an |
Publication date of an |
.Sx \&Rs |
.Sx \&Rs |
block. This should follow the reduced syntax for |
block. This should follow the reduced or canonical form syntax |
|
described in |
.Sx Dates . |
.Sx Dates . |
Canonical or non-canonical form is not necessary since publications are |
|
often referenced only by year, or month and year. |
|
. |
. |
.Ss \&%I |
.Ss \&%I |
Publisher or issuer name of an |
Publisher or issuer name of an |
Line 759 block. This macro may also be used in a non-bibliogra |
|
Line 747 block. This macro may also be used in a non-bibliogra |
|
when referring to article titles. |
when referring to article titles. |
. |
. |
.Ss \&%U |
.Ss \&%U |
URI of current document. |
URI of reference document. |
. |
. |
.Ss \&%V |
.Ss \&%V |
Volume number of an |
Volume number of an |
|
|
field may be either |
field may be either |
.Ar $\&Mdocdate$ , |
.Ar $\&Mdocdate$ , |
which signifies the current manual revision date dictated by |
which signifies the current manual revision date dictated by |
.Xr cvs 1 |
.Xr cvs 1 , |
or instead a valid canonical date as specified by |
or instead a valid canonical date as specified by |
.Sx Dates . |
.Sx Dates . |
|
If a date does not conform, the current date is used instead. |
.Pp |
.Pp |
Examples: |
Examples: |
.Bd -literal -offset indent |
.Bd -literal -offset indent |
|
|
.Sx \&Er . |
.Sx \&Er . |
. |
. |
.Ss \&Dx |
.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. |
value if no argument is provided. |
.Pp |
.Pp |
Examples: |
Examples: |
|
|
.Ss \&Lb |
.Ss \&Lb |
.Ss \&Li |
.Ss \&Li |
.Ss \&Lk |
.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 |
|
See also |
|
.Sx \&Mt . |
|
. |
.Ss \&Lp |
.Ss \&Lp |
.Ss \&Ms |
.Ss \&Ms |
.Ss \&Mt |
.Ss \&Mt |