Re: docs/172868: [PATCH] fix header.ent change Introduction -> For newbies

2013-06-01 Thread eadler
Synopsis: [PATCH] fix header.ent change Introduction -> For newbies

State-Changed-From-To: open->closed
State-Changed-By: eadler
State-Changed-When: Sat Jun 1 10:53:18 UTC 2013
State-Changed-Why: 
I don't think we will be making this change

http://www.freebsd.org/cgi/query-pr.cgi?pr=172868
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"


removing 'changes' section from the online edition

2013-06-01 Thread Eitan Adler
Hi all,

The Preface has a few sections 'Changes from the  Edition' which
enumerate changes made between print editions of the book.  I would
like to drop them from the online edition as they offer little value
and are right at the start of the handbook ('prime real estate').

They can be retained in the print edition where they offer a little more value.

Does anyone see a reason to keep them in the online version?

-- 
Eitan Adler
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"


Re: removing 'changes' section from the online edition

2013-06-01 Thread Gabor Kovesdan

Em 01-06-2013 18:26, Eitan Adler escreveu:

The Preface has a few sections 'Changes from the  Edition' which
enumerate changes made between print editions of the book.  I would
like to drop them from the online edition as they offer little value
and are right at the start of the handbook ('prime real estate').

They can be retained in the print edition where they offer a little more value.

Does anyone see a reason to keep them in the online version?
No objection from me, I just want to bring it up again that handling 
these with a single-source solution would be nice, i.e. using DocBook 
profiling. It would also facilitate merges. This basically consists of 
adding edition="print" to the affected section of preface and then 
setting up profiling. (I can do it, just ping me if there is consensus 
on this).


Gabor
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"


Re: removing 'changes' section from the online edition

2013-06-01 Thread Chris Rees
On 1 Jun 2013 18:39, "Gabor Kovesdan"  wrote:
>
> Em 01-06-2013 18:26, Eitan Adler escreveu:
>
>> The Preface has a few sections 'Changes from the  Edition' which
>> enumerate changes made between print editions of the book.  I would
>> like to drop them from the online edition as they offer little value
>> and are right at the start of the handbook ('prime real estate').
>>
>> They can be retained in the print edition where they offer a little more
value.
>>
>> Does anyone see a reason to keep them in the online version?
>
> No objection from me, I just want to bring it up again that handling
these with a single-source solution would be nice, i.e. using DocBook
profiling. It would also facilitate merges. This basically consists of
adding edition="print" to the affected section of preface and then setting
up profiling. (I can do it, just ping me if there is consensus on this).

I don't see how anyone could disagree with that :)

Is there an "old version" capability there?

Chris
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"


Re: removing 'changes' section from the online edition

2013-06-01 Thread Gabor Kovesdan

Em 01-06-2013 19:46, Chris Rees escreveu:

I don't see how anyone could disagree with that:)

Is there an "old version" capability there?

What do you exactly mean old version capability?

What I'm suggesting consists in that elements marked as edition="online" 
only go to the online version and those marked as edition="print" only 
go to the print version. The rest is rendered in both. This also 
requires setting some parameters in the Makefile and will just work.


Gabor
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"


Re: removing 'changes' section from the online edition

2013-06-01 Thread Chris Rees
On 1 Jun 2013 18:55, "Gabor Kovesdan"  wrote:
>
> Em 01-06-2013 19:46, Chris Rees escreveu:
>
>> I don't see how anyone could disagree with that:)
>>
>> Is there an "old version" capability there?
>
> What do you exactly mean old version capability?
>
> What I'm suggesting consists in that elements marked as edition="online"
only go to the online version and those marked as edition="print" only go
to the print version. The rest is rendered in both. This also requires
setting some parameters in the Makefile and will just work.

I'm thinking edition="FreeBSD-7" etc.  Just a thought, and it's probably
irrelevant, sorry.

Chris
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"


Re: removing 'changes' section from the online edition

2013-06-01 Thread Warren Block

On Sat, 1 Jun 2013, Gabor Kovesdan wrote:


Em 01-06-2013 18:26, Eitan Adler escreveu:

The Preface has a few sections 'Changes from the  Edition' which
enumerate changes made between print editions of the book.  I would
like to drop them from the online edition as they offer little value
and are right at the start of the handbook ('prime real estate').

They can be retained in the print edition where they offer a little more 
value.


Does anyone see a reason to keep them in the online version?
No objection from me, I just want to bring it up again that handling these 
with a single-source solution would be nice, i.e. using DocBook profiling. It 
would also facilitate merges. This basically consists of adding 
edition="print" to the affected section of preface and then setting up 
profiling. (I can do it, just ping me if there is consensus on this).


Yes!  I was just talking about this elsewhere.  Could we do it so only 
the non-print sections need to be modified?

___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"


Re: removing 'changes' section from the online edition

2013-06-01 Thread Gabor Kovesdan

Em 01-06-2013 20:23, Chris Rees escreveu:
I'm thinking edition="FreeBSD-7" etc.  Just a thought, and it's 
probably irrelevant, sorry.

Not entirely possible yet but there are plans to support this.

Gabor
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"


Re: removing 'changes' section from the online edition

2013-06-01 Thread Gabor Kovesdan

Em 01-06-2013 20:52, Warren Block escreveu:
No objection from me, I just want to bring it up again that handling 
these with a single-source solution would be nice, i.e. using DocBook 
profiling. It would also facilitate merges. This basically consists 
of adding edition="print" to the affected section of preface and then 
setting up profiling. (I can do it, just ping me if there is 
consensus on this).


Yes!  I was just talking about this elsewhere.  Could we do it so only 
the non-print sections need to be modified? 
You only need to add edition="online" to non-print sections. And only 
need to add edition="print" to non-online sections. The rest is shared 
and the markup is kept minimal.


Gabor
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"


Re: removing 'changes' section from the online edition

2013-06-01 Thread Eitan Adler
On 1 June 2013 19:39, Gabor Kovesdan  wrote:
> Em 01-06-2013 18:26, Eitan Adler escreveu:
>
>> The Preface has a few sections 'Changes from the  Edition' which
>> enumerate changes made between print editions of the book.  I would
>> like to drop them from the online edition as they offer little value
>> and are right at the start of the handbook ('prime real estate').
>>
>> They can be retained in the print edition where they offer a little more
>> value.
>>
>> Does anyone see a reason to keep them in the online version?
>
> No objection from me, I just want to bring it up again that handling these
> with a single-source solution would be nice, i.e. using DocBook profiling.
> It would also facilitate merges. This basically consists of adding
> edition="print" to the affected section of preface and then setting up
> profiling. (I can do it, just ping me if there is consensus on this).

I agree.  Profiling is a much better solution than a fork for our use cases.

-- 
Eitan Adler
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"


Re: removing 'changes' section from the online edition

2013-06-01 Thread Warren Block

On Sat, 1 Jun 2013, Gabor Kovesdan wrote:


Em 01-06-2013 20:52, Warren Block escreveu:
No objection from me, I just want to bring it up again that handling these 
with a single-source solution would be nice, i.e. using DocBook profiling. 
It would also facilitate merges. This basically consists of adding 
edition="print" to the affected section of preface and then setting up 
profiling. (I can do it, just ping me if there is consensus on this).


Yes!  I was just talking about this elsewhere.  Could we do it so only the 
non-print sections need to be modified? 
You only need to add edition="online" to non-print sections. And only need to 
add edition="print" to non-online sections. The rest is shared and the markup 
is kept minimal.


How do you control which is included when the document is built?
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"


Correccion sobre hci

2013-06-01 Thread Luis Manuel Sánchez
Hola... Lei el articulo de Bluetooth en espanol y encuentro que hci  host
controller interface esta mal traducido.
http://www.freebsd.org/doc/es_ES.ISO8859-1/books/handbook/network-bluetooth.html

Propongo la siguiente tradiccion...
" interface maquina controlador"
Espero vean la razon. Saludos!
___
freebsd-doc@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"