Bug#840153: Should have various tutorial manpages

2016-10-27 Thread Sean Whitton
On Thu, Oct 27, 2016 at 02:38:47PM +0100, Ian Jackson wrote: > > After the docs upload, it might be good to do some advertising. > > Misc. Developer News at least. > > I was intending another d-d-a posting. Great. Both the patches-unapplied and the tutorials should attract interest. -- Sean

Bug#840153: Should have various tutorial manpages

2016-10-27 Thread Ian Jackson
Sean Whitton writes ("Re: Bug#840153: Should have various tutorial manpages"): > On Thu, Oct 27, 2016 at 10:29:02AM +0100, Ian Jackson wrote: > > But, I'll have whatever you can produce in a week or so. I think > > 2.8 (!) may migrate and then I'll be wantin

Bug#840153: Should have various tutorial manpages

2016-10-27 Thread Sean Whitton
On Thu, Oct 27, 2016 at 10:29:02AM +0100, Ian Jackson wrote: > But, I'll have whatever you can produce in a week or so. I think > 2.8 (!) may migrate and then I'll be wanting to upload a new version > with better docs. Okay. I'm planning to look at this on Saturday. After the docs upload, it

Bug#840153: Should have various tutorial manpages

2016-10-27 Thread Ian Jackson
Sean Whitton writes ("Re: Bug#840153: Should have various tutorial manpages"): > On Thu, Oct 27, 2016 at 01:02:43AM +0100, Ian Jackson wrote: > > Are you still intending to look into dgit-maint-gbp(7) ? > > Would you prefer to release a short manpage with a few remarks,

Bug#840153: Should have various tutorial manpages

2016-10-26 Thread Sean Whitton
Hello Ian, On Thu, Oct 27, 2016 at 01:02:43AM +0100, Ian Jackson wrote: > FYI, I have been working on dgit-user(7) and dgit-nmu-simple(7). > I think they're mostly done. I'll take a look! > dgit-sponsorship(7) is next on my list. That would be great. I spend a lot of time on d-mentors so I

Bug#840153: Should have various tutorial manpages

2016-10-26 Thread Ian Jackson
FYI, I have been working on dgit-user(7) and dgit-nmu-simple(7). I think they're mostly done. If you would like to review what I have, you can find them here http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=dgit.git;a=tree;h=refs/heads/wip.tutorials;hb=refs/heads/wip.tutorials

Bug#840153: Should have various tutorial manpages

2016-10-21 Thread Ian Jackson
Sean Whitton writes ("Re: Bug#840153: Should have various tutorial manpages"): > Yes, just my habit of hitting M-q in Emacs. > > Are the semantic newlines for the benefit of someone editing the .pod, > or for the benefit of a future natural-language parsing computer? I >

Bug#840153: Should have various tutorial manpages

2016-10-20 Thread Sean Whitton
Dear Ian, On Fri, Oct 21, 2016 at 01:28:14AM +0100, Ian Jackson wrote: > All I saw in your commit message was the rewrapping. But now I look > at it again there is an additional blank line too. > > The rewrapping replaces the semantic newlines (which I used when I > rewrote that paragraph) with

Bug#840153: Should have various tutorial manpages

2016-10-20 Thread Ian Jackson
Ian Jackson writes ("Re: Bug#840153: Should have various tutorial manpages"): > I don't mind the additional paragraph break. Ie, like this. The output of pod2man | man -l is the same. Ian. >From de9555e90291fcfa3d374bc02d1a5fff8a3f7617 Mon Sep 17 00:00:00 2001 From: Sean

Bug#840153: Should have various tutorial manpages

2016-10-20 Thread Ian Jackson
Sean Whitton writes ("Bug#840153: Should have various tutorial manpages"): > control: tag -1 -patch > ^ since no patch for the other manpages listed in the first message Thanks, yes. > On Thu, Oct 20, 2016 at 08:38:48PM +0100, Ian Jackson wrote: > > As for your final

Bug#840153: Should have various tutorial manpages

2016-10-20 Thread Sean Whitton
control: tag -1 -patch ^ since no patch for the other manpages listed in the first message Hello, On Thu, Oct 20, 2016 at 08:38:48PM +0100, Ian Jackson wrote: > As for your final patch "dgit-maint-merge(7): spacing". Is there a > reason in a .pod file not to use semantic whitespace ? >

Bug#840153: Should have various tutorial manpages

2016-10-20 Thread Ian Jackson
Sean Whitton writes ("Bug#840153: Should have various tutorial manpages"): > On Thu, Oct 20, 2016 at 01:37:46AM +0100, Ian Jackson wrote: > > You might want to mention that if you do this check, you might as well > > use the upstream tarball rather than `git-a

Bug#840153: Should have various tutorial manpages

2016-10-19 Thread Sean Whitton
Hello Ian, On Thu, Oct 20, 2016 at 01:37:46AM +0100, Ian Jackson wrote: > Sean Whitton writes ("Re: Bug#840153: Should have various tutorial manpages"): > > On Wed, Oct 19, 2016 at 09:31:28PM +0100, Ian Jackson wrote: > > I'll ensure that I don't commit stuff that

Bug#840153: Should have various tutorial manpages

2016-10-19 Thread Ian Jackson
Sean Whitton writes ("Re: Bug#840153: Should have various tutorial manpages"): > On Wed, Oct 19, 2016 at 09:31:28PM +0100, Ian Jackson wrote: > I'll ensure that I don't commit stuff that doesn't build, now that I > know I can submit patches by publishing a branch somewhere.

Bug#840153: Should have various tutorial manpages

2016-10-19 Thread Sean Whitton
Hello Ian, On Wed, Oct 19, 2016 at 09:31:28PM +0100, Ian Jackson wrote: > Sean Whitton writes ("Bug#840153: Should have various tutorial manpages"): > > control: tag -1 +patch > > > > Please find attached git-am(1)-amenable patches adding some pod2man > > i

Bug#840153: Should have various tutorial manpages

2016-10-19 Thread Ian Jackson
Sean Whitton writes ("Bug#840153: Should have various tutorial manpages"): > control: tag -1 +patch > > Please find attached git-am(1)-amenable patches adding some pod2man > infrastructure, and dgit-maint-merge(7). Thanks! I really like your new manpage. I have

Bug#840153: Should have various tutorial manpages -- fixed patch submission

2016-10-18 Thread Sean Whitton
Hello, On Tue, Oct 18, 2016 at 05:35:37PM -0700, Sean Whitton wrote: > Please find attached git-am(1)-amenable patches adding some pod2man > infrastructure, and dgit-maint-merge(7). > > (I'm keen to retain the authorship information in the actual manpage, > but you might not like how I've edited

Bug#840153: Should have various tutorial manpages

2016-10-18 Thread Sean Whitton
control: tag -1 +patch Please find attached git-am(1)-amenable patches adding some pod2man infrastructure, and dgit-maint-merge(7). (I'm keen to retain the authorship information in the actual manpage, but you might not like how I've edited d/copyright, so I made that a separate patch.) --

Bug#840153: Should have various tutorial manpages

2016-10-18 Thread Ian Jackson
Sean Whitton writes ("Re: Bug#840153: Should have various tutorial manpages"): > Would you accept a patch to your Makefile to compile manpages from > perl's POD format? Or is there some other format you'd prefer? I'd > like to confirm in advance of starting to write. Ye

Bug#840153: Should have various tutorial manpages

2016-10-17 Thread Sean Whitton
Hello Ian, Would you accept a patch to your Makefile to compile manpages from perl's POD format? Or is there some other format you'd prefer? I'd like to confirm in advance of starting to write. I'm impressed that you seem to have written the existing dgit.7 and dgit.1 in troff, but I'd rather

Bug#840153: Should have various tutorial manpages

2016-10-08 Thread Ian Jackson
Package: dgit Version: 1.4 For example: dgit-userfor users of any Debian-derived distro, including how to edit packages dgit-nmu-simple for Debian developers doing an NMU dgit-maint-nativemaintain native packages in Debian dgit-maint-merge