On 8/28/13 9:46 AM, Charles Merriam wrote:
> I guess I looked at documentation as the low hanging fruit, but failed
> to figure out its build system in a day. It is unclear how welcome
> little fixes are, and I get tired of making patches that get ignored.
On 8/28/13 9:49 AM, Craig Earls wrote:
With respect to patches, if I have ignored any documentation patches I
am sorry, I completely missed them. As far as building the docs, cd
into the docs directory and run the gendocs script ../tools/gendocs.sh
Comments like Charles' are a bad sign and should be taken very
seriously, if we want this to be a thriving project. I'm glad Craig replied.
Regarding the ledger 3 manual. The script Craig mentions generates the
info and pdf formats, but not the html format. The html version is what
most folks use, via http://ledger-cli.org/docs.html . I also had severe
problems figuring out the current build system. Here's what I came up
with to build the html docs for ledger-cli.org:
./acprep make doc -- -DBUILD_WEB_DOCS=1
But I see that's not working for me today. Indeed
http://ledger-cli.org/3.0/doc/ledger3.html seems not to have been
regenerated since 2013/1/29! Which is really confusing and a black mark
for me if true. I thought I had been testing it more recently than that.
To fix the official manual on the website, I need a reliable command
that I can use to build the html docs, from whoever installed the
current build system (or anyone).
As for the rest of the website, contributing to this should be easy.
http://ledger-cli.org -> contribute -> About ledger-cli.org describes
the setup and points to the github repo. Any patch or pull request which
you get committed there will appear on the website right away (fixed
yesterday).
--
---
You received this message because you are subscribed to the Google Groups "Ledger" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
For more options, visit https://groups.google.com/groups/opt_out.
