docliftertest1(1)

NAME
docliftertest1 - section 1 test load for doclifter

SYNOPSIS
docliftertest1 [-a | -b] [optional...] docliftertest1 -c <required>

docliftertest1 -d [ optional ]

docliftertest1 [ -e | -f foo ] ...

DESCRIPTION
This file is a test load for doclifter, intended to exercise as much as possible of its translation capability. You are now reading the last sentence of an ordinary paragraph; by inspecting the output, you can check that your formatter is generating a correct beginning-of-body even after the section title, and an end-of-body event at the end of the paragraph.

This is an ordinary paragraph started by a .PP macro. A second line illustrates the effect of filling.

This word should be bold. This word should be small. The word ASCII is actually an acronym. This is a reference to section: SEE ALSO it should be a link now. Visiting the SYNOPSIS is important. While the SYNOPYOSIS is not important and doesn't exist. Thissentenceshouldalternateitalicandbold. The words in the last sentence should have been run together.

This is an ordinary paragraph started by a .LP macro. A second line illustrates the effect of filling.

This is a paragraph started by an .HP macro. We translate it to DocBook as an ordinary paragraph break.

&   This paragraph was led with .IP & 5. A sample line to see how it formats -- it should turn into list markup.

There should be an index entry generated right after this sentence. And right before this one.

5   This paragraph was led with .IP 5. This should turn into an ordinary paragraph.

This paragraph contains a URL, http://www.google.com, that doesn't have explicit .UR/.UN tags around it. It should not be marked up, because .UR/.UN tags exist in this document.

•   This is the first item in a bulleted list.

•   This is the second item in a bulleted list.

•   This is the third item in a bulleted list.

This is another ordinary paragraph. It's going to be immediately followed (without an intervening paragraph tag) by a table example lifted straight from Mike Lesk's original tbl paper:
1970 Federal Budget Transfers
(in billions of dollars)
State | Taxes | Money | Net
 | collected | spent |
New York | 22.91 | 21.35 | -1.56
New Jersey | 8.33 | 6.96 | -1.37
Connecticut | 4.12 | 3.10 | -1.02
Maine | 0.74 | 0.67 | -0.07
California | 22.29 | 22.42 | +0.13
New Mexico | 0.70 | 1.49 | +0.79
Georgia | 3.30 | 4.28 | +0.98
Mississippi | 1.15 | 2.32 | +1.17
Texas | 9.33 | 11.13 | +1.80
In the above table, the presence or absence of cell borders may not be exactly as tbl(1) specified them (the DocBook DSSL toolchain sets BORDER=1 if there is any frame attribute, which is wrong; according to the DocBook specification, the frame attribute should only control box drawing around the exterior of the table). But the horizontal spanning and centering should be displayed properly.

  MORE TABLES
We just started a subsection.

Here's another table. The first line of the table contains a heading centered across all three columns; each remaining line contains a left-adjusted item in the first column followed by two columns of numerical data. (The numerical alignment won't translate into DocBook.)
Overall title
Item-a | 34.22 | 9.1
Item-b | 12.65 | .02
Items: c,d,e | 23 | 5.8
Total | 69.87 | 14.92
This table illustrates the effect of the expand option:
Bell Labs Locations
Name | Address | Area Code | Phone
Holmdel | Holmdel, N. J. 07733 | 201 | 949-3000
Murray Hill | Murray Hill, N. J. 07974 | 201 | 582-6377
Whippany | Whippany, N. J. 07981 | 201 | 386-3000
Indian Hill | Naperville, Illinois 60540 | 312 | 690-2000
Here's a really gnarly table with a lot of vertically spanned content and several multiline items per line. However this is not done with a vertically-spanned format; for that, see the next example.
Some Interesting Places
Name | Description | Practical Information
American Museum of Natural History | The collections fill 11.5 acres (Michelin) or 25 acres (MTA) of exhibition halls on four floors. There is a full-sized replica of a blue whale and the world's largest star sapphire (stolen in 1964). | Hours | 10-5, ex. Sun 11-5, Wed. to 9
 |  | Location | Central Park West & 79th St.
 |  | Admission | Donation: $1.00 asked
 |  | Subway | AA to 81st St.
 |  | Telephone | 212-873-4225
Bronx Zoo | About a mile long and .6 mile wide, this is the largest zoo in America. A lion eats 18 pounds of meat a day while a sea lion eats 15 pounds of fish. | Hours | 10-4:30 winter, to 5:00 summer
 |  | Location | 185th St. & Southern Blvd, the Bronx.
 |  | Admission | $1.00, but Tu,We,Th free
 |  | Subway | 2, 5 to East Tremont Ave.
 |  | Telephone | 212-933-1759
Brooklyn Museum | Five floors of galleries contain American and ancient art. There are American period rooms and architectural ornaments saved from wreckers, such as a classical figure from Pennsylvania Station. | Hours | Wed-Sat, 10-5, Sun 12-5
 |  | Location | Eastern Parkway & Washington Ave., Brooklyn.
 |  | Admission | Free
 |  | Subway | 2,3 to Eastern Parkway.
 |  | Telephone | 212-638-5000
New-York Historical Society | All the original paintings for Audubon's are here, as are exhibits of American decorative arts, New York history, Hudson River school paintings, carriages, and glass paperweights. | Hours | Tues-Fri & Sun, 1-5; Sat 10-5
 |  | Location | Central Park West & 77th St.
 |  | Admission | Free
 |  | Subway | AA to 81st St.
 |  | Telephone | 212-873-3400
OK, here is a table example with spanned vertical format. It illustrates the vertical-spanning bug noted on the doclifter(1) manual page (but troff2docbook(1) translates this table correctly). If the translation were completely correct, the "E" entry would span one row further downward.
A | B | C
D | E | F
G |  | H
I |  | J

Now we'll test PIC translation to SVG. This line tests recognition of superscripting) ,br This line tests recognition of the other superscript idiom.

FILES
The following items illustrate .TP markup:

${HOME}/.profile
    read at startup by sh(1).

/etc/hosts
    list of static host addresses used by the bind(8) library.

SEE ALSO
ls(1), mkdir(1).