Came across this and thought I would share it. It has quite a few good pointers and words of wisdom for working with DocBook. The first one being, if you are using verbatim text, do not exceed 70 characters. So a lot of the stuff in the developers manual with or needs to be broken up manually. While space (i.e. carriage returns) will be respected.
The problem is to break up lines that people will (and should be able to) copy and paste directly from the manual into their terminal (for convenience, but also in order to not make mistakes). Typically cURL commands etc
Came across this and thought I would share it. It has quite a few good pointers and words of wisdom for working with DocBook. The first one being, if you are using verbatim text, do not exceed 70 characters. So a lot of the stuff in the developers manual with or needs to be broken up manually. While space (i.e. carriage returns) will be respected.
Yeah, I see the problem. I will think about this, but I think in this case, we need another element somehow without the line breaks using the attribute. But if this is not a URL, it may not work. Will read a bit and see what i can come up with.
···
On Tue, Sep 30, 2014 at 11:49 AM, Knut Staring knutst@gmail.com wrote:
The problem is to break up lines that people will (and should be able to) copy and paste directly from the manual into their terminal (for convenience, but also in order to not make mistakes). Typically cURL commands etc
Came across this and thought I would share it. It has quite a few good pointers and words of wisdom for working with DocBook. The first one being, if you are using verbatim text, do not exceed 70 characters. So a lot of the stuff in the developers manual with or needs to be broken up manually. While space (i.e. carriage returns) will be respected.