2994 – Incomplete "Predefined Versions" documentation

D issues are now tracked on GitHub. This Bugzilla instance remains as a read-only archive.
Issue 2994 - Incomplete "Predefined Versions" documentation
Summary: Incomplete "Predefined Versions" documentation
Status: RESOLVED FIXED
Alias: None
Product: D
Classification: Unclassified
Component: dlang.org (show other issues)
Version: D1 (retired)
Hardware: All All
: P2 normal
Assignee: No Owner
URL: http://www.digitalmars.com/d/1.0/vers...
Keywords: spec
Depends on:
Blocks: 677
Show dependency tree / graph
Reported: 2009年05月16日 14:25 UTC by Nick Sabalausky
Modified: 2014年04月18日 09:15 UTC (History)
5 users (show)

See Also:


Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this issue.
Description Nick Sabalausky 2009年05月16日 14:25:46 UTC
The D1 and D2 documentation for "Predefined Versions" does not include macintosh/osx, does not mention how FreeBSD is handled, and does not point out any distinction between "linux" and "Posix".
Comment 1 Nick Sabalausky 2009年05月16日 14:28:25 UTC
It also doesn't mention how Solaris is handled.
Comment 2 Anders F Bj 2009年05月17日 02:51:11 UTC
DMD doesn't handle Solaris yet afaik, GDC calls it "solaris":
http://www.prowiki.org/wiki4d/wiki.cgi?DocComments/Version 
Comment 3 Tomas Lindquist Olsen 2009年05月17日 04:42:38 UTC
"Solaris" is a predefined version identifier in DMD 1.045
Comment 4 Stewart Gordon 2009年05月17日 14:37:40 UTC
How is the distinction between GUI and console apps on Mac OS X handled, given such incompatibilities between them as the line break style?
And what about whatever other 32+-bit platforms exist? (Game consoles? iPhone? ....)
Comment 5 Stewart Gordon 2009年05月18日 13:57:17 UTC
I'm thinking now that the best solution may be to have an official list of version identifiers for OSs maintained separately from the D1 and D2 specs, and have those specs link to this list. That way, once the D1 spec is finished, this list can still be kept up to date with new OSs that may emerge, ready for anyone wanting to write a D compiler therefor.
Comment 6 Brad Roberts 2009年06月07日 16:04:36 UTC
I'd rather see the spec fully contained within the spec, not having references to external sites. As further justification to my view, in addition to version identifiers, the ABI part of the spec likely needs updates for new platforms too. Just because they're not implemented by DMD doesn't mean the spec shouldn't contain those platforms.
So, for those that maintain compilers that support other platforms, can you attach a diff for at least the version identifiers and file another bug report to update the abi portion of the spec as well? :)
Thanks,
Brad
Comment 7 Stewart Gordon 2009年06月07日 16:40:30 UTC
(In reply to comment #6)
> I'd rather see the spec fully contained within the spec, not having references
> to external sites. 
Well, obviously it wouldn't be an external site. It would be a list somewhere on the D website but separate from the core language spec. Or maybe a page that is in the spec but with an exemption made from freezing to allow for additions of new platforms.
> As further justification to my view, in addition to version
> identifiers, the ABI part of the spec likely needs updates for new platforms
> too. Just because they're not implemented by DMD doesn't mean the spec
> shouldn't contain those platforms.
Yes, that's exactly why I proposed this. The ABI page should be dealt with in the same way as the predefined version page.
I suppose it's a matter of creating a "Platform specifics" section of the specs. This would cover not only the predefined versions and ABI, but also such things as the inline assembler and possibly the current pages on Win32 specifics.
Comment 8 Brad Roberts 2009年06月07日 18:03:52 UTC
> (In reply to comment #6)
> Or maybe a page that is in the spec but with an exemption made from freezing
> to allow for additions of new platforms.
Ah, well, the freeze of the D1 spec has been pragmatic enough to support updates like this anyway, so no need to worry terribly much about that.
I'll reach out on the digitalmars.D newsgroup to attempt to gather up the current list to fold in so this bug can be closed out.
Comment 9 anonymous4 2009年06月10日 03:14:28 UTC
(In reply to comment #0)
> does not mention how FreeBSD is handled, and does not point out
> any distinction between "linux" and "Posix".
Platform identifiers are provided for user code so that it can work platform-dependent and it's up to user code to handle it in any way needed. For example it's used in core.stdc.stdio to version out various declaration.
Comment 10 Walter Bright 2010年11月09日 18:50:43 UTC
Updated from compiler source cond.c.
http://www.dsource.org/projects/phobos/changeset/2147 


AltStyle によって変換されたページ (->オリジナル) /