[Box Backup-dev] DocProject editing setup

[E.W. Peter Jalajas]

Moving off of boxbackup mailing list to boxbackup-dev...

Sorry, Per, but I just don't have any experience with xml, so I'm gonna
need a lot more hand-holding.  Rather than quitting and running away,
let me try a couple of baby steps.  Maybe this thread will help others
join the doc team.

1) Here's what I have for xml editors:  

I'm on gnome on ubuntu dapper linux (debian).  I have screem and
bluefish which both seem to have xml functions built in.  I'll try them
both after we get the rest of this thing set up.  (I'm fairly
proficient at vi/vim, if that helps. gedit has xml highlighting, fwiw.)

2) Here's what I have for xsltproc and docbook:

$ dpkg -l | grep xsltproc
ii  xsltproc                               1.1.15-1ubuntu1    XSLT
command line processor
$ dpkg -l | grep docbook
ii  docbook-dsssl                          1.79-3    modular DocBook
DSSSL stylesheets, for print
ii  docbook-utils                          0.6.14-1    Convert Docbook
files to other formats (HTML
ii  docbook-xml                            4.4-4    standard XML
documentation system, for softw
ii  docbook-xsl                            1.68.1-0.1ubuntu1   
stylesheets for processing DocBook XML files

How does that look?  1.68 looks bad per the DocProject page.  I'm not
sure I want to start messing with a dependency hell, but I'm open to
suggestions.  Maybe I can just stay away from man pages? 

3) Here's what I have for stylesheets:  

The DocProject page mentions getting stylesheets.  I see stylesheets in
the listing above; do I need anything else re that?  I have no clue how
to use them yet.

4) Here's what I have for subversion:

I didn't have it installed, so I ran

sudo apt-get install subversion

and so now I have:

$ dpkg -l | grep -e subversion -e svn
ii  libnl1-pre6                            1.0~pre5+svn21-2ubuntu2   
Library for dealing with netlink sockets
ii  libsvn0                                1.3.1-3ubuntu1    shared
libraries used by Subversion (aka. sv
ii  subversion                             1.3.1-3ubuntu1    advanced
version control system (aka. svn)

The boxbackup-dev mailing list mentions transferring the svn repository
and integrating with trac.  Do I need to do anything with that info?
 
5) Editing a doc:

Say I want to add content re windows regex in bbackupd.conf (like I was
gonna do in the wiki).  I found:

http://bbdev.fluffy.co.uk/trac/browser/box/trunk/documentation/boxbackup/adminguide.xml
and
http://bbdev.fluffy.co.uk/svn/box/trunk/documentation/boxbackup/adminguide.xml

I registered as petej on the trac page, so is it safe to presume the
trac file is the one I should checkout/edit/checkin?  I'll need some
instructions on how to checkout/checkin that file.

Thanks for your patience, Per!  
Pete

--- Per Thomsen <pthomsen@reedtz.com> wrote:

> On 8/10/06 1:57 PM, E.W. Peter Jalajas wrote:
> The instructions are on the Wiki: 
> http://boxbackup.hostworks.ca/index.php/DocProject
> 
> If you have questions about any of this, please feel free to contact
> me.
> 
> Thanks,
> Per


ASK ME about the EXCITING new TebucoSafe(TM) web-based automated secure off-site backup service!  Never think about backups again! As low as $19/mo.  http://tebuco.com/bu/

E.W. Peter Jalajas
Tebuco, Inc. | Technical Business Consulting 
pjalajas@tebuco.com | http://tebuco.com/ 
cell:  978-495-2062 | (secondary phone: 978-465-7047 x27)
PO Box 1223, Newburyport, MA  01950-8223

Automated, secure, off-site, on-line backup service.
On-site and remote technical support.