stabilize path names in html output

Max Bowsher maxb at ukf.net
Fri May 20 14:32:43 CDT 2005


Olaf Hering wrote:
> On Wed, May 18, Max Bowsher wrote:
...
>> However, the book is a general piece of information not necessarily
>> customized for any particular Subversion installation, so I do not think
>> customized substitutions are required.
>
> I build the svnbook from source and put svn-book.html into our
> subversion-doc package.
>
>> There are already several different preferences for a system repository
>> base path, and of course repositories can actually go anywhere at all, so 
>> I
>> think it's fine just to use one in the book, and let people apply their
>> personal preferences to their own systems.
>
> Sure, the desired values can be overridden via make options.
>
>> Regarding binary paths, I suggest just using "/usr/bin/" everywhere -
>> anyone who custom-installs Subversion somewhere else will easily 
>> understand
>> the change they need to make to examples.
>
> I can prepare such a patch, if XML entities are not wanted.

I think it comes down to authors' preference here - in other words:

sussman/cmpilato/fitz - we have a question for you:

Regarding the location of example repositories, and the location of the 
binaries...
Is it desirable to allow the builder of the book to specify custom 
substitutions at build time?

My worry is that this may make it hard to control the line length in command 
line demo sections.

Max.




More information about the svnbook-dev mailing list