Mailing-List: contact dev-help@karaf.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@karaf.apache.org
Received-SPF: pass (nike.apache.org: domain of gnodet@gmail.com designates
 74.125.82.176 as permitted sender)
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=gmail.com; s=gamma;
        h=mime-version:date:message-id:subject:from:to:content-type;
        b=Xty56r/IdGfL5g+E4pao265bUJlgxWHmXsD+6/irFvi991GrRe77c+0cZ6SMJFX3rW
         jHD3Izqeu/2/FRoVwhsVFDvK5ujM1I0rssr6pgBNdV9lFrvRFL6XNrI2s1wwed4yWi0i
         9b6cSwSAu3sWRCoI6EK8EJvHwOS8Jm4xPa7xE=
MIME-Version: 1.0
Date: Mon, 18 Oct 2010 10:25:39 +0200
Message-ID: <AANLkTimm5tNPzGCgXRhf0RyzZ7zUR-B5mLYs4VDJ3E0F@mail.gmail.com>
Subject: Manual using scalate now in svn
From: Guillaume Nodet <gnodet@gmail.com>
To: dev@karaf.apache.org
Content-Type: multipart/alternative; boundary=0016e659fde8ddf59f0492dfeb26

--0016e659fde8ddf59f0492dfeb26
Content-Type: text/plain; charset=ISO-8859-1

I've committed the project i've been working on github so far in the main
svn are, in trunk/documentation.
In order to keep that up-to-date with each version, I'd ask anyone to keep
it in sync when you modify / add a new feature in Karaf.
Note that this manual includes an auto-generated section containing all the
commands, so we could try to improve the help for those.
It can be done by adding the following attribute on the annotation as it's
done in the grep command

   @Command(...., detailedDescription="classpath:grep.txt")

And then a file in
   org/apache/karaf/shell/commands/grep.txt
The file is loaded from the command class (hence it's automatically prefixed
by the package name, unless an absolute uri is used).

I guess we could try to auto-discover this file too btw.

The manual is not fully complete and there are still sections to review /
fill, so feel free to have a look at those.

Also, I'll try to publish a snapshot and have it linked from the main web
site and use it instead of the wiki based manuals, so that we'll have easier
versioning.
But we need to come up with a better design for the web pages and add a pdf
output.  Help welcome!


-- 
Cheers,
Guillaume Nodet
------------------------
Blog: http://gnodet.blogspot.com/
------------------------
Open Source SOA
http://fusesource.com

--0016e659fde8ddf59f0492dfeb26--