Hi Sean, On Tue, Jun 13, 2017 at 06:42:28PM +0100, Sean Whitton wrote: > Hello Nicholas, > > On Mon, Jun 12, 2017 at 07:33:12PM -0400, Nicholas D Steeves wrote: > > Would it be better to ship README.org and file a bug against the > > package myself? > > Yes. Why not ship README.org in the interim?
Let's discuss .org documentation at DebConf. I've converted the README to plaintext for now. > > How many lines can I dedicate to this? By my count I need to > > summarise the following in five lines, and the most salient additions > > are the mention of diminish.el, plus compare/contrast by adding what I > > suspect are the two most salient points. > > * "/missing/...quick and simple replacement functionality" > > * the addition of "It accepts *regexps* instead of [individual > > specifications]". > > Where are you getting this line limit from? In the same way that lines must be hard-wrapped to fit a 80 column terminal I inferred that long description should also fit in a 24 line terminal, and that README should used for anything longer. Maybe it's not a hard rule, but this has always struck me as a sort of standard. At any rate, I've updated the description. > > These two points seem contradictory to me. Do you know how > > diminish.el is more quick and simple? Also, can I use your answer for > > a patch against the upstream description, because I might not be the > > only one who's not confused about this. Failing that, I can open an > > upstream issue/request for clarified description. > > diminish.el works like this: > > (diminish 'auto-fill-function) > > That's it. Clearly simpler. I think this is probably the simplest rich-minority-mode equivalent, assuming that subsequent (diminish 'minor-mode-function) adds items to-be-hidden: (push " Fill" rm-blacklist) I haven't investigated corner cases, but it would seem that rich-minority-mode might also be simple :-) All of your comments should be addressed by 419b8ca which I believe is ready to upload. I would be very appreciative if you would also grand DM permissions for it :-) Thank you, Nicholas
signature.asc
Description: Digital signature