Hello,

Russ Allbery [08/Feb  8:58am -08] wrote:
> Sean Whitton <[email protected]> writes:
>
>> I strongly dislike (3) because I find it to be a distraction from
>> producing good prose; I don't think sentence-by-sentence like that.
>> I also find that the way Emacs's VC mode displays diffs (called diff
>> "refinement" but I don't really understand why it's called that) means
>> that there aren't any issues with reviewing diffs, so it seems like
>> just working around a limitation of certain web based diff views?
>
> Okay, no problem. I think of it primarily as working better with Git and
> patch, whose standard diff display and exchange tools work line-by-line,
> but I do realize it's often off-putting to people who haven't done a lot
> of work in that style.

Oh, I work in that style all the time, indeed it's my main working style
(we're still only e-mailing patches around on emacs-devel).  It's when
it comes to writing and editing the files that I find it harmful.

>> I think that it is okay for the text of Policy to end up with a mix of
>> sentences ending with one space and two spaces depending on who the
>> original author of that particular segment was.
>
>> I would prefer if we allowed mass reformatting to use two spaces
>> (e.g. before doing a bunch of edits) but disallowed mass reformatting to
>> use one space, based on the idea that the majority of the text is
>> currently two spaces, but maybe this is too much my own personal
>> preference, so perhaps we should allow mass reformatting like that in
>> both directions of sections one is about to edit?
>
> I'm not entirely sure what you mean by mass formatting. Certainly I don't
> think we should go through and make whitespace-only changes. Right now, if
> I reflow a paragraph with M-q, that's going to change all the spacing
> after periods unless I reconfigure my editor. Maybe that counts as mass
> formatting? (It's limited to just that paragraph.)

Yes, that's what I meant by mass reformatting -- changing all the
sentences in a paragraph, before/while actually editing that paragraph.

> To be clear, I'm very happy to configure my editor and use two spaces
> after periods in Policy if you would prefer! I don't feel strongly about
> this, and I am continuing to use two spaces after periods in POD
> documentation for various reasons related to *roff formatting, so my
> editor and brain is capable of switching back and forth.
>
> I have a mild preference for not worrying about it, but if it would bother
> you enough to want to reformat it, I'm happy to just use two spaces.

If I was editing a paragraph intensively, I might first use 'M-x
repunctuate-sentences' to switch it over to using two spaces.  If I was
making minor changes I probably wouldn't feel any need to do that.

I do have a mild personal preference for you and any contributor to use
two spaces.  But I would never actually ask someone to change their
patch so that it did that.

So if it is easy for you to reconfigure your editor, then I won't deny
that I would appreciate it, but otherwise I am happy to continue mixing
the two styles depending on who authored some text.

-- 
Sean Whitton

Attachment: signature.asc
Description: PGP signature

Reply via email to