[Issue 15227] std.format undocumented grammar

[d-bugmail--- via Digitalmars-d-bugs]

https://issues.dlang.org/show_bug.cgi?id=15227

Dlang Bot  changed:

   What|Removed |Added

 Status|NEW |RESOLVED
 Resolution|--- |FIXED

--- Comment #6 from Dlang Bot  ---
dlang/phobos pull request #7927 "Fix Issue 15227 - std.format undocumented
grammar" was merged into master:

- d5cb431b70935a87b926dd7db3fe2241e6300331 by berni44:
  Fix Issue 15227 - std.format undocumented grammar

https://github.com/dlang/phobos/pull/7927

--

[Issue 15227] std.format undocumented grammar

[d-bugmail--- via Digitalmars-d-bugs]

https://issues.dlang.org/show_bug.cgi?id=15227

Dlang Bot  changed:

   What|Removed |Added

   Keywords||pull

--- Comment #5 from Dlang Bot  ---
@berni44 created dlang/phobos pull request #7927 "Fix Issue 15227 - std.format
undocumented grammar" fixing this issue:

- Fix Issue 15227 - std.format undocumented grammar

https://github.com/dlang/phobos/pull/7927

--

[Issue 15227] std.format undocumented grammar

[d-bugmail--- via Digitalmars-d-bugs]

https://issues.dlang.org/show_bug.cgi?id=15227

Walter Bright  changed:

   What|Removed |Added

   See Also||https://issues.dlang.org/sh
   ||ow_bug.cgi?id=3248

--

[Issue 15227] std.format undocumented grammar

[d-bugmail--- via Digitalmars-d-bugs]

https://issues.dlang.org/show_bug.cgi?id=15227

Seb  changed:

   What|Removed |Added

   Keywords||bootcamp
 CC||greensunn...@gmail.com

--

[Issue 15227] std.format undocumented grammar

[via Digitalmars-d-bugs]

https://issues.dlang.org/show_bug.cgi?id=15227

--- Comment #4 from Doug Nickerson  ---
Correction: the 2013 edition link should be:
http://pubs.opengroup.org/onlinepubs/9699919799/functions/printf.html

--

[Issue 15227] std.format undocumented grammar

[via Digitalmars-d-bugs]

https://issues.dlang.org/show_bug.cgi?id=15227

--- Comment #3 from Doug Nickerson  ---
In addition to the undocumented syntax I've further noticed:
- grammar for 'Integer' technically allows leading 0's and disallows negative
integers
- 'Integer' is used in the grammar for both non-negative (Position) and
negative (Width, Precision) purposes
- the 'r' (raw) and 'u' (unsigned) format spec characters are not documented
anywhere (neither in the grammar or the rest of the text)

That last bullet is probably more important than any other.

Caveat on the original issue: there is indeed a hyperlink very early on in the
formattedWrite documentation, which goes to an external page that does explain
the positional syntax/semantics: "%n$" and "*m$" but not the forms involving
':'

Incidentally, that page (2004 edition) indicates a newer version is available:
http://pubs.opengroup.org/onlinepubs/9699919799/  (2013 edition).  However, it
doesn't appear to have anything new regarding positional notation.

Related question: is there a reason, or should std.format support the 'i', 'p',
or 'n' format spec characters from the *printf family of functions?

--

[Issue 15227] std.format undocumented grammar

[via Digitalmars-d-bugs]

https://issues.dlang.org/show_bug.cgi?id=15227

--- Comment #2 from Jack Stouffer  ---
In addition to the above problems, the examples in text should be moved to unit
test examples.

--

[Issue 15227] std.format undocumented grammar

[via Digitalmars-d-bugs]

https://issues.dlang.org/show_bug.cgi?id=15227

Vladimir Panteleev  changed:

   What|Removed |Added

 CC||j...@jackstouffer.com,
   ||rburn...@gmail.com,
   ||thecybersha...@gmail.com
   See Also||https://issues.dlang.org/sh
   ||ow_bug.cgi?id=3479

--- Comment #1 from Vladimir Panteleev  ---
The code seems to have been added by Andrei Alexandrescu himself back in 2011:

https://github.com/D-Programming-Language/phobos/commit/e068168273e4200bbf0c44e5ebba6a697a714b97
https://issues.dlang.org/show_bug.cgi?id=3479

CCing our diligent documentation writers.

--