[Pkg-crosswire-devel] Git repository, and manpages

[Jonathan Marsden]

Dima,

Дмитрий Ледков wrote:

> Jonathan could you please start commiting to it? Currently it only has
> your first revision.

Yes, I really should... yesterday I was just focused on getting the
initial packaging work done, and then the rpath issue on amd64 took up
*way* too much of my limited brainpower to be learning git at the same
time :)

By the way, there are some typos and stuff in your GitGuide that I'd
like to tidy up.  I think I am jmarsden-guest on alioth, but that
doesn't seem to work as a wiki user login, so I can't edit the page!
Can you please help me get wiki edit access somehow?  (And, if I can
somehow drop the -guest and become jmarsden on alioth, so much the
better!).  I'm all fairly nicely set up in the Ubuntu world (on
Launchpad, on their wiki, etc etc) but not established at all in
Debian-land.  If there is a  web page somewhere that tells me how to get
myself all set up, just let me know the URL.  Thanks.

>> (2) Man pages!  I'm hoping for some man pages for all the little cli
>> tools that we install, so that we can get this package lintian-clean in
>> the next couple of days or so.

> I've strated writting manpages. I've finished (almost) diatheke manual.
> It is committed on the manpages branch.

Great!  Thanks for doing this.

> Please review it! To make sure it builds, installs, and whether there
> are any mistakes. If you are ok merged it into master along with your
> 3 revisions.

OK, can do.  Well, assuming I have the rights to merge to master in the
repository.  Is it set so that anyone on this list can do that??

> I wrote them in POD format, that's why this branch brings in perl as
> build dependency, and I have added the rules to generate and install it.
> 
> IMHO POD format at least is readable in source form.

Sure.  I don't *like* the Perl dependency, but I understand why POD is
easier than groff markup (well, unless you've been in the Unix world for
some years and so already know groff)!

For others who might be able to help out with documentation: Please note
that https://wiki.ubuntu.com/PackagingGuide/Howtos/PODManpage explains
how to do what Dima is doing regarding man page writing.  Now all those
who said they want to help and are lurking silently on the list have no
excuse... start writing man pages :-)

BTW, Dima: I think you are xnox on Freenode, right?  We missed each
other in #sword yesterday by not very much... I answered your question
there about 30 minutes after you asked it!

Jonathan