Re: RFC: Upgrading to DocBook 5.0

2013-07-14 Thread Hiroki Sato
Gabor Kovesdan wrote in <51e2ea74.9070...@freebsd.org>: ga> >> It breaks the list. It is even worse in PDF rendering since there are ga> >> page boundaries and it breaks the page up to two parts. ga> > ga> > I see what you mean. But if we say "don't use admonitions in lists ga> > because they

Title formatting (was Re: RFC: Upgrading to DocBook 5.0)

2013-07-14 Thread Warren Block
On Sun, 14 Jul 2013, Gabor Kovesdan wrote: I find different fonts for filenames and commands to be useful, even in titles. The O'Reilly style guide doesn't mention anything about title styles, and in a quick search I did not find anything else. Ok, it doesn't specify it explicitly but can you

Re: RFC: Upgrading to DocBook 5.0

2013-07-14 Thread Gabor Kovesdan
On 2013.07.14. 18:02, Warren Block wrote: On Sun, 14 Jul 2013, Gabor Kovesdan wrote: Em 14-07-2013 14:52, Warren Block escreveu: On Sun, 14 Jul 2013, Gábor Kövesdán wrote: Some more things: - Admonitions (top, note, warning boxes) look quite strange in lists and such places. I think we sho

Re: RFC: Upgrading to DocBook 5.0

2013-07-14 Thread Warren Block
On Sun, 14 Jul 2013, Gabor Kovesdan wrote: Em 14-07-2013 14:52, Warren Block escreveu: On Sun, 14 Jul 2013, Gábor Kövesdán wrote: Some more things: - Admonitions (top, note, warning boxes) look quite strange in lists and such places. I think we should add a policy to avoid them and start c

Re: RFC: Upgrading to DocBook 5.0

2013-07-14 Thread Gabor Kovesdan
Em 14-07-2013 14:52, Warren Block escreveu: On Sun, 14 Jul 2013, Gábor Kövesdán wrote: Some more things: - Admonitions (top, note, warning boxes) look quite strange in lists and such places. I think we should add a policy to avoid them and start changing the markup. Admonitions are overuse

Re: RFC: Upgrading to DocBook 5.0

2013-07-14 Thread Warren Block
On Sun, 14 Jul 2013, Gábor Kövesdán wrote: Some more things: - Admonitions (top, note, warning boxes) look quite strange in lists and such places. I think we should add a policy to avoid them and start changing the markup. Admonitions are overused in some places. They are visually jarring,

docs/180551: [patch] document NULL encryption algorithm in geli(8)

2013-07-14 Thread r4...@tormail.org
>Number: 180551 >Category: docs >Synopsis: [patch] document NULL encryption algorithm in geli(8) >Confidential: no >Severity: non-critical >Priority: low >Responsible:freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class:

Re: RFC: Upgrading to DocBook 5.0

2013-07-14 Thread Gábor Kövesdán
Some more things: - Admonitions (top, note, warning boxes) look quite strange in lists and such places. I think we should add a policy to avoid them and start changing the markup. - We extensively use markup in titles, which later renders with a different font. E.g. we mark the X of 9.X as r