NL.n Use namespaces, do nest your namespaces. Do not use a suffix or prefix in all defined names to provide scope.

[SimonTemplate]

Reason:
Provides a narrow context where defined names are short, external names are well marked and also naturally segments your header-files, this makes larger code sets more easy to browse and comprehend and aids with refactoring.

Chances are your IDE provides a folding mechanism for namespaces, which is great when browsing these larger pieces of code.

Examples:

Alternatives:

Exceptions:
extern “C”

Enforcement:
Lint defined names and suggest shortening of long names, find repeated prefixes.

See also:

Notes:
Do not use reversed Internet domain names as namespaces, as java frequently do for package names.

Discussion:
Maybe GitHub could be persuaded to provide a global top-namespace allocatioin mechanism ?

[Pazns]

Do not follow the java path and start using DNS names, or any other global names.

Can you be clearer :-) ?

[SimonTemplate]

@Pazns, I edited the line and tried to be clearer, hope it worked.

[LegalizeAdulthood]

This feels like many recommendations disguised as a single recommendation. For guidance, I'd prefer to see a single recommendation for each point instead of lumped all together. The "don't use DNS names" for organizing namespaces is sure to find some push-back particularly when coupled with the idea of using github to create yet-another-global-ad-hoc-registry for which the DNS already serves (which is why Java adopted that in the first place).

[SimonTemplate]

@LegalizeAdulthood well I agree, but as there are a number of subheaders in the rule template I got into adding more opinions, maybe I should split into a number of distinct recommendations.

[LegalizeAdulthood]

@SimonTemplate It's fine for it all to be lumped together as items discussed in the issue. A pull request should split out the separate concerns.

[Pazns]

@SimonTemplate Yeah, thanks.

What is the idea behind this convention, by the way ?
What if a company doesn't have a domain name ?
How could namespaces benefit from a link with a domain name hierarchy like this ? Even if said namespaces don't exist ?

[SimonTemplate]

@Pazns Do NOT use reversed Internet domain names as a namespace hierarchy, is the idéa. I.e.there is no need for any domain names.

[Pazns]

@SimonTemplate Sorry it wasn't very understable, I was asking about this Java convention totally aside your proposition for the guidelines (with which I agree).

Is there any reasons for this DNS-style naming ? It seems a weird choice to me, bringing confusion of meaning if a real domain name hierarchy doesn't exist.

[SimonTemplate]

@Pazns I suppose it's piggybacking on this DNS global naming authority, there are not many such authorities available. But the names contains too many levels and as Java also mirrors this into the folder structure it is rather unwieldy, IMHO.

[hpesoj]

I think trying to allocate top level namespaces would probably create more problems than it solved. If two popular libraries which are likely to be used together have conflicting namespaces, they can resolve it between themselves. And I can't imagine this happening all that often.

[SimonTemplate]

@hpesoj Well, assuming a reasonable number of libraries, I suppose it will work.

[grahamreeds]

In Java (and .Net) it is natural to have nested namespaces and resulting
deep file hierarchies. It is only unwieldy in C++. And even then you don't
have to nest your file structure.

In fact the only thing that makes it unwieldy is the inability to easily
nest namespaces.

Ie:
namespace foo { namespace bar { namespace stein {

As opposed to

namespace foo::bar::stein {

GR

Sent from my Nexus 5.
On 13 Jan 2016 10:08 a.m., "SimonTemplate" notifications@github.com wrote:

I suppose it's piggybacking on this DNS global naming authority, there are
not many such authorities available. But the names contains too many levels
and as Java also mirrors this into the folder structure it is rather
unwieldy, IMHO.

—
Reply to this email directly or view it on GitHub
#497 (comment)
.

[LegalizeAdulthood]

I thought the N4230 proposal for nested namespaces was on track for C++17?