Sean Whitton writes ("Bug#901927: Manpage suggestions"):
> [Ian:]
> > Somewhere in git-debrebase(5) ?  Maybe git-debrebase(5) wants a new
> > TIPS AND NOTES section or something, right after the INTRODUCTION ?
> 
> I guess git-debrebase(5) would be fine, but IMO it would be weird to
> have TIPS AND NOTES after INTRODUCTION.
> 
> How about adding a TIPS AND NOTES appendix to git-debrebase(5)?  Since
> git-debrebase(5) describes a data model, to my mind tips for using that
> data model belong in an appendix.

I think it could do with being a bit more prominent.

Looking at the top of git-debrebase(5), the 2nd half of INTRODUCTION
is rather discursive.  Maybe add a section heading just before,
DISCUSSION or something, and put the gitk thing there ?

Ian.

-- 
Ian Jackson <ijack...@chiark.greenend.org.uk>   These opinions are my own.

If I emailed you from an address @fyvzl.net or @evade.org.uk, that is
a private address which bypasses my fierce spamfilter.

Reply via email to