headers
Tim Rightnour | 18 Dec 2007 04:51
Gravatar

Importing docs back into usr/share/docs


I would like to start importing back in some of the old documentation from
4.4BSD (working in conjunction with Matt Fleming).  However, rather than import
things as 02.foo, I would like to import it as just "foo".  This way, if we
decide in the future to update some of this documentation, we are not bound by
the chapter numbering of the past.

While we could allways do that anyhow, the problem is that it becomes confusing
to have chapter 7 be 02.foo.

I don't see a need however, to delete and move the stuff we have to different
names, just newly added stuff.  Moving it about inside the repository would
just be churn.

(yes, I already jumped the gun on smm/config, which I can back out if need be)

---
Tim Rightnour <root <at> garbled.net>
NetBSD: Free multi-architecture OS http://www.netbsd.org/
Genecys: Open Source 3D MMORPG: http://www.genecys.org/
Permalink | Reply | 1 comment |
headers
James K. Lowden | 24 Dec 2007 07:15
Gravatar

mdoc tables

What's the trick -- or is there none? -- to make mdoc rows wrap within
their column?  

I'm used to HTML tables, where browser does the work or, worst case, the
rows follow the column width specified at the start of the table.  But my
first-ever mdoc man page is giving me fits.   

.Bl -column ".Sy Property\ \ \ " ".Sy Range\ \ \ \ \ \ \ " ".Sy Default\ \
\ \ \ \ "  ".Sy Meaning"

.It Sy Property Ta Sy Range Ta Sy Default Ta Sy Meaning

.It Li tds version Ta 4.2, 5.0, 7.0, 8.0 Ta --with-tdsver value (5.0 if
unspecified) Ta TDS protocol version to use

I would like "4.2, 5.0, 7.0, 8.0" to wrap with the width indicated by ".Sy
Range\ \ \ \ \ \ \ ".  Instead it intrudes into the third column, the 3rd
into the fourth, and the fourth column wraps in a tiny strand down the
right edge of the page.  

Is this why so many man pages choose an expository style over a tabular
one?  

I've looked for mdoc discussions/examples on the www.  Pretty much all I
find is copies of GROFF_MDOC(7).  

Thanks for any help.  

--jkl
(Continue reading)

Permalink | Reply | 1 comment |
headers
Pavel Cahyna | 27 Dec 2007 13:28
Picon

Re: mdoc tables

On Mon, Dec 24, 2007 at 01:15:21AM -0500, James K. Lowden wrote:
> What's the trick -- or is there none? -- to make mdoc rows wrap within
> their column?  
> 
> I'm used to HTML tables, where browser does the work or, worst case, the
> rows follow the column width specified at the start of the table.  But my
> first-ever mdoc man page is giving me fits.   
> 
> .Bl -column ".Sy Property\ \ \ " ".Sy Range\ \ \ \ \ \ \ " ".Sy Default\ \
> \ \ \ \ "  ".Sy Meaning"
> 
> .It Sy Property Ta Sy Range Ta Sy Default Ta Sy Meaning
> 
> .It Li tds version Ta 4.2, 5.0, 7.0, 8.0 Ta --with-tdsver value (5.0 if
> unspecified) Ta TDS protocol version to use
> 
> I would like "4.2, 5.0, 7.0, 8.0" to wrap with the width indicated by ".Sy
> Range\ \ \ \ \ \ \ ".  Instead it intrudes into the third column, the 3rd
> into the fourth, and the fourth column wraps in a tiny strand down the
> right edge of the page.  
> 
> Is this why so many man pages choose an expository style over a tabular
> one?  
> 
> I've looked for mdoc discussions/examples on the www.  Pretty much all I
> find is copies of GROFF_MDOC(7).  

the sysctl(7) man page has some examples of tables.

Pavel
(Continue reading)

Permalink | Reply | 0 comments |

Gmane