[svn.haxx.se] · SVN Dev · SVN Users · SVN Org · TSVN Dev · TSVN Users · Subclipse Dev · Subclipse Users · this month's index

Re: [PROPOSAL] Change of convention for multiline string literals

From: Ivan Zhakov <chemodax_at_gmail.com>
Date: 2007-05-01 16:00:39 CEST

On 4/22/07, Jonathan Gilbert <o2w9gs702@sneakemail.com> wrote:
> At 11:58 PM 3/27/2007 +0100, Max wrote:
> >Jonathan Gilbert wrote:
> >> At 10:12 PM 3/18/2007 -0500, I wrote:
> >> [snip]
> >>> In light of this, I would like to revise my proposal to suggest that the
> >>> macro be named either EOL or NL (to keep it as short as possible), that it
> >>> be defined in a Subversion-internal header so that it is not visible to
> >>> outside code (as it lacks the SVN_ prefix that would otherwise keep it
> from
> >>> polluting the namespace), and that the EOL or NL tokens be lined up so
> that
> >>> they terminate in the 79th column. In the event that a line of text really
> >>> cannot be broken up and it is long enough that the EOL or NL token could
> >>> not be lined up in this manner with at least 2 characters of separation
> >>> from the text, the EOL or NL should be placed wherever the end of that
> >>> particular line is with the two spaces of separation.
> >>
> >> In the hopes of somehow at least partly extricating my foot from my mouth,
> >> attached is a revised patch which uses NL instead of SVN_NL, defines this
> >> new namespace-less macro in include/private/svn_compat.h (following a brief
> >> chat on IRC with C. Michael Pilato) and lines things up so that, as much as
> >> possible, they fit nicely into an 80x25 console window. I even reviewed the
> >> changes by opening the files in VIM on Windows in a default 80x25 console
> >> window. :-)
> >>
> >> I also thought it would make sense to propose the use of NL over
> >> APR_EOL_STR only for multiline string literals, so I reverted the changes
> >> in the previous version of the patch which changed APR_EOL_STR where used
> >> in other places, such as parameters to functions, newline matching, etc.
> >> The patch is a bit smaller, though not a lot since the bulk of the changes
> >> still apply and are simply a little bit different.
> >>
> >> Thoughts? Ready to be applied?
> >
> >Given that this only affects just 4 source files, and the odd
> >namespaceless nature of the new define, I'd personally opt for just
> >doing "#define NL APR_EOL_STR" in each file that needs it.
> >
> >Apart from that, +1.
>
> Okay, well I finally found time to brush the dust off this one and post the
> revised patch. I decided to keep the semicolons in the same line, because
> the worst that can happen is that an editor will wrap onto the next line,
> and that's what the alternative would be anyway. May as well have it on the
> same line for those environments that support it. :-)
>
> The NL macros are now defined independently for each of the files which
> uses them. I kept the descriptive comment next to the #define so people
> will know why it's there.
>
> Should I also prepare a patch to hacking.html to describe this change to
> the multi-line string literal policy?
>
> Thanks,
>
> Jonathan Gilbert
>
Committed slightly tweaked patch in r24861.
I'll be happy if you prepare patch to hacking.html to describe this
change. Thanks!

-- 
Ivan Zhakov
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Tue May 1 16:00:53 2007

This is an archived mail posted to the Subversion Dev mailing list.

This site is subject to the Apache Privacy Policy and the Apache Public Forum Archive Policy.