public inbox for gentoo-pms@lists.gentoo.org
 help / color / mirror / Atom feed
* [gentoo-pms] Clarify line continuation in make.defaults
@ 2010-01-13 18:40 Jacob Godserv
  2010-01-13 21:01 ` Christian Faulhammer
  0 siblings, 1 reply; 10+ messages in thread
From: Jacob Godserv @ 2010-01-13 18:40 UTC (permalink / raw
  To: gentoo-pms

[-- Attachment #1: Type: text/plain, Size: 878 bytes --]

This patch fixes a fairly small issue, but one that "got" me enough
times, while writing a PMS-compatible tool, to make me want to patch.

The wording on how a quoted string might continue over more than one
line is only barely enough to grasp its meaning. It requires some deep
logical thought to figure out what's actually meant here, so I've
added a little bit of extra explanation.

I found that nano set to COLUMNS=107 produced word wrapping similar to
the rest of the file, but let me know if I missed other formatting
rules I ought to know about.

-- 
    Jacob

    "For then there will be great distress, unequaled
    from the beginning of the world until now — and never
    to be equaled again. If those days had not been cut
    short, no one would survive, but for the sake of the
    elect those days will be shortened."

    Are you ready?

[-- Attachment #2: profiles.tex.patch --]
[-- Type: application/octet-stream, Size: 750 bytes --]

--- profiles.tex	2010-01-13 13:28:25.103670768 -0500
+++ profiles.tex	2010-01-13 13:35:50.712458151 -0500
@@ -58,7 +58,8 @@
 \item Variables to the right of the equals sign in the form \t{\$\{foo\}} or \t{\$foo} are recognised and
   expanded from variables previously set in this or earlier \t{make.defaults} files.
 \item One logical line may be continued over multiple physical lines by escaping the newline with a
-  backslash. This is also permitted inside quoted strings.
+  backslash. A quoted string may also continue over multiple physical lines in this fasion, so that 
+  the quoted string can begin, continue, and end on two or more separate lines.
 \item Backslashes, except for line continuations, are not allowed.
 \end{compactitem}
 

^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: [gentoo-pms] Clarify line continuation in make.defaults
  2010-01-13 18:40 [gentoo-pms] Clarify line continuation in make.defaults Jacob Godserv
@ 2010-01-13 21:01 ` Christian Faulhammer
  2010-01-17  4:07   ` [gentoo-pms] Fill column (was: Re: Clarify line continuation in make.defaults) Ulrich Mueller
       [not found]   ` <2e0007041001141034w25cea618r3a0119b748aa3362@mail.gmail.com>
  0 siblings, 2 replies; 10+ messages in thread
From: Christian Faulhammer @ 2010-01-13 21:01 UTC (permalink / raw
  To: gentoo-pms

[-- Attachment #1: Type: text/plain, Size: 1001 bytes --]

Hi,

Jacob Godserv <jacobgodserv@gmail.com>:
> The wording on how a quoted string might continue over more than one
> line is only barely enough to grasp its meaning. It requires some deep
> logical thought to figure out what's actually meant here, so I've
> added a little bit of extra explanation.

 That's fine by me.  If you prepare the patch with git format-patch,
you would be able to see your name in the VCS system.  We will wait for
comments from others, thanks for your contribution.

> I found that nano set to COLUMNS=107 produced word wrapping similar to
> the rest of the file, but let me know if I missed other formatting
> rules I ought to know about.

 A thing I would like to talk about it.  Why is the line wrap the way
it is?  Emacs always complains and he has the authority regarding line
wrap.

V-Li

-- 
Christian Faulhammer, Gentoo Lisp project
<URL:http://www.gentoo.org/proj/en/lisp/>, #gentoo-lisp on FreeNode

<URL:http://gentoo.faulhammer.org/>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 198 bytes --]

^ permalink raw reply	[flat|nested] 10+ messages in thread

* [gentoo-pms] Fill column (was: Re: Clarify line continuation in make.defaults)
  2010-01-13 21:01 ` Christian Faulhammer
@ 2010-01-17  4:07   ` Ulrich Mueller
  2010-01-17  8:47     ` Ciaran McCreesh
       [not found]   ` <2e0007041001141034w25cea618r3a0119b748aa3362@mail.gmail.com>
  1 sibling, 1 reply; 10+ messages in thread
From: Ulrich Mueller @ 2010-01-17  4:07 UTC (permalink / raw
  To: Christian Faulhammer; +Cc: gentoo-pms

>>>>> On Wed, 13 Jan 2010, Christian Faulhammer wrote:

>  A thing I would like to talk about it.  Why is the line wrap the way
> it is?  Emacs always complains and he has the authority regarding line
> wrap.

Lines with a width of 100 characters are hard to read, therefore I
would much prefer a more conventional value like 70 or 72. Maybe with
exceptions for some of the tables.

A good time for making such a change would be when EAPI 3 is finished.
What do you think?

Ulrich



^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: [gentoo-pms] Fill column (was: Re: Clarify line continuation in  make.defaults)
  2010-01-17  4:07   ` [gentoo-pms] Fill column (was: Re: Clarify line continuation in make.defaults) Ulrich Mueller
@ 2010-01-17  8:47     ` Ciaran McCreesh
  2010-01-17  9:30       ` [gentoo-pms] Fill column Christian Faulhammer
  0 siblings, 1 reply; 10+ messages in thread
From: Ciaran McCreesh @ 2010-01-17  8:47 UTC (permalink / raw
  To: Ulrich Mueller; +Cc: gentoo-pms

2010/1/17 Ulrich Mueller <ulm@gentoo.org>:
>>>>>> On Wed, 13 Jan 2010, Christian Faulhammer wrote:
>>  A thing I would like to talk about it.  Why is the line wrap the way
>> it is?  Emacs always complains and he has the authority regarding line
>> wrap.
>
> Lines with a width of 100 characters are hard to read, therefore I
> would much prefer a more conventional value like 70 or 72. Maybe with
> exceptions for some of the tables.
>
> A good time for making such a change would be when EAPI 3 is finished.
> What do you think?

Oh heck no. There's no excuse for using 70 or 80 columns for source
code any more. My old laptop can fit 100 across the screen
comfortably, which is much cleaner to work with.

This bikeshed does not need repainting bright pink with orange spots.

-- 
Ciaran McCreesh



^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: [gentoo-pms] Fill column
  2010-01-17  8:47     ` Ciaran McCreesh
@ 2010-01-17  9:30       ` Christian Faulhammer
  2010-01-17  9:50         ` Ciaran McCreesh
  0 siblings, 1 reply; 10+ messages in thread
From: Christian Faulhammer @ 2010-01-17  9:30 UTC (permalink / raw
  To: gentoo-pms

[-- Attachment #1: Type: text/plain, Size: 1044 bytes --]

Hi,

Ciaran McCreesh <ciaran.mccreesh@googlemail.com>:
> > Lines with a width of 100 characters are hard to read, therefore I
> > would much prefer a more conventional value like 70 or 72. Maybe
> > with exceptions for some of the tables.
> >
> > A good time for making such a change would be when EAPI 3 is
> > finished. What do you think?
> 
> Oh heck no. There's no excuse for using 70 or 80 columns for source
> code any more. My old laptop can fit 100 across the screen
> comfortably, which is much cleaner to work with.

 We don't talk about source code but continous text even if having some
mark-up around.  And best readability for such text is around 60
characters per line, languages with long words may have more.

> This bikeshed does not need repainting bright pink with orange spots.

 And you don't want us to argue about the colour, right?

V-Li

-- 
Christian Faulhammer, Gentoo Lisp project
<URL:http://www.gentoo.org/proj/en/lisp/>, #gentoo-lisp on FreeNode

<URL:http://gentoo.faulhammer.org/>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 198 bytes --]

^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: [gentoo-pms] Fill column
  2010-01-17  9:30       ` [gentoo-pms] Fill column Christian Faulhammer
@ 2010-01-17  9:50         ` Ciaran McCreesh
  2010-01-17 10:01           ` Christian Faulhammer
  0 siblings, 1 reply; 10+ messages in thread
From: Ciaran McCreesh @ 2010-01-17  9:50 UTC (permalink / raw
  To: Christian Faulhammer; +Cc: gentoo-pms

2010/1/17 Christian Faulhammer <fauli@gentoo.org>:
>> Oh heck no. There's no excuse for using 70 or 80 columns for source
>> code any more. My old laptop can fit 100 across the screen
>> comfortably, which is much cleaner to work with.
>
>  We don't talk about source code but continous text even if having some
> mark-up around.  And best readability for such text is around 60
> characters per line, languages with long words may have more.

And the *generated* text is wrapped that way, or however else we want
it to be. We're discussing the source code, however, which is a whole
other thing, and none of your readability studies for printed texts
are relevant for it.

>> This bikeshed does not need repainting bright pink with orange spots.
>
>  And you don't want us to argue about the colour, right?

I don't want you to go and break 'git blame' etc and screw around with
something that doesn't need changing, yes. The not-quite-arbitrary
decision of "what fits on my laptop screen" that was originally made
is equally as good as or better than any alternative.

-- 
Ciaran McCreesh



^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: [gentoo-pms] Fill column
  2010-01-17  9:50         ` Ciaran McCreesh
@ 2010-01-17 10:01           ` Christian Faulhammer
       [not found]             ` <82dd739f1001170311o14aafd13n8a140fc4c9ab487@mail.gmail.com>
  0 siblings, 1 reply; 10+ messages in thread
From: Christian Faulhammer @ 2010-01-17 10:01 UTC (permalink / raw
  To: gentoo-pms

[-- Attachment #1: Type: text/plain, Size: 1528 bytes --]

Hi,

Ciaran McCreesh <ciaran.mccreesh@googlemail.com>:
> 2010/1/17 Christian Faulhammer <fauli@gentoo.org>:
> >> Oh heck no. There's no excuse for using 70 or 80 columns for source
> >> code any more. My old laptop can fit 100 across the screen
> >> comfortably, which is much cleaner to work with.
> >
> >  We don't talk about source code but continous text even if having
> > some mark-up around.  And best readability for such text is around
> > 60 characters per line, languages with long words may have more.
> 
> And the *generated* text is wrapped that way, or however else we want
> it to be. We're discussing the source code, however, which is a whole
> other thing, and none of your readability studies for printed texts
> are relevant for it.

 But usually I read diffs on the screen and seldomly read PMS in
formatted text, so not my readability studies but scientific facts
apply here as well.

> I don't want you to go and break 'git blame' etc and screw around with
> something that doesn't need changing, yes. The not-quite-arbitrary
> decision of "what fits on my laptop screen" that was originally made
> is equally as good as or better than any alternative.

 git blame is an argument, right.  The line wrapping goes on my nerve
for quite some time but I postponed any complaints until some real work
is done.

V-Li


-- 
Christian Faulhammer, Gentoo Lisp project
<URL:http://www.gentoo.org/proj/en/lisp/>, #gentoo-lisp on FreeNode

<URL:http://gentoo.faulhammer.org/>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 198 bytes --]

^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: [gentoo-pms] Clarify line continuation in make.defaults
       [not found]   ` <2e0007041001141034w25cea618r3a0119b748aa3362@mail.gmail.com>
@ 2010-01-17 11:16     ` Christian Faulhammer
  0 siblings, 0 replies; 10+ messages in thread
From: Christian Faulhammer @ 2010-01-17 11:16 UTC (permalink / raw
  To: Jacob Godserv; +Cc: gentoo-pms

[-- Attachment #1: Type: text/plain, Size: 655 bytes --]

Hi,

Jacob Godserv <jacobgodserv@gmail.com>:
> On Wed, Jan 13, 2010 at 16:01, Christian Faulhammer
> <fauli@gentoo.org> wrote:
> >  That's fine by me.  If you prepare the patch with git format-patch,
> > you would be able to see your name in the VCS system.  We will wait
> > for comments from others, thanks for your contribution.
> 
> Still learning git, but I think I figured it out. Attached.

 Looks good and applied with one typo fix.  Thanks for your
 contribution.

V-Li

-- 
Christian Faulhammer, Gentoo Lisp project
<URL:http://www.gentoo.org/proj/en/lisp/>, #gentoo-lisp on FreeNode

<URL:http://gentoo.faulhammer.org/>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 198 bytes --]

^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: [gentoo-pms] Fill column
       [not found]               ` <20100117142956.125b2e18@gentoo.org>
@ 2010-01-17 14:36                 ` Ciaran McCreesh
       [not found]                   ` <19283.12619.238117.318780@a1i15.kph.uni-mainz.de>
  0 siblings, 1 reply; 10+ messages in thread
From: Ciaran McCreesh @ 2010-01-17 14:36 UTC (permalink / raw
  To: Christian Faulhammer; +Cc: gentoo-pms

2010/1/17 Christian Faulhammer <fauli@gentoo.org>:
>  git blame breakage is no argument here, as the initial import damages
> that anyway.

No, that's still useful, since it shows things that've been around
since the beginning and that haven't been tidied up.

> Usually everyone agrees on 80 characters

80 characters is for people who use dumb terminals that don't support
any other size. It's annoyingly restrictive for anything else.

> Derivating from that must be justified better than "it fits my screen".

No, changing it from what it is currently requires better
justification than "a piece of hardware that no-one's used for twenty
years does it that way".

Also, please stop stealthily changing bits of wrapping as you go
along. That's even worse.

-- 
Ciaran McCreesh



^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: [gentoo-pms] Fill column
       [not found]                   ` <19283.12619.238117.318780@a1i15.kph.uni-mainz.de>
@ 2010-01-17 17:53                     ` Ciaran McCreesh
  0 siblings, 0 replies; 10+ messages in thread
From: Ciaran McCreesh @ 2010-01-17 17:53 UTC (permalink / raw
  To: Ulrich Mueller; +Cc: gentoo-pms

2010/1/17 Ulrich Mueller <ulm@kph.uni-mainz.de>:
>>>>>> On Sun, 17 Jan 2010, Ciaran McCreesh wrote:
>> 80 characters is for people who use dumb terminals that don't support any other size. It's annoyingly restrictive for anything else.
>
> Then let's change it to 300 characters width, which can be easily displayed on modern dual-headed displays. 100 characters is still too restrictive and cramps my style.

Since you're now being silly, I take it we all agree upon leaving it
as it is. Good.

-- 
Ciaran McCreesh



^ permalink raw reply	[flat|nested] 10+ messages in thread

end of thread, other threads:[~2010-01-17 17:53 UTC | newest]

Thread overview: 10+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2010-01-13 18:40 [gentoo-pms] Clarify line continuation in make.defaults Jacob Godserv
2010-01-13 21:01 ` Christian Faulhammer
2010-01-17  4:07   ` [gentoo-pms] Fill column (was: Re: Clarify line continuation in make.defaults) Ulrich Mueller
2010-01-17  8:47     ` Ciaran McCreesh
2010-01-17  9:30       ` [gentoo-pms] Fill column Christian Faulhammer
2010-01-17  9:50         ` Ciaran McCreesh
2010-01-17 10:01           ` Christian Faulhammer
     [not found]             ` <82dd739f1001170311o14aafd13n8a140fc4c9ab487@mail.gmail.com>
     [not found]               ` <20100117142956.125b2e18@gentoo.org>
2010-01-17 14:36                 ` Ciaran McCreesh
     [not found]                   ` <19283.12619.238117.318780@a1i15.kph.uni-mainz.de>
2010-01-17 17:53                     ` Ciaran McCreesh
     [not found]   ` <2e0007041001141034w25cea618r3a0119b748aa3362@mail.gmail.com>
2010-01-17 11:16     ` [gentoo-pms] Clarify line continuation in make.defaults Christian Faulhammer

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox