[phobos] [D-Programming-Language/phobos] f34b41: Fix & improve readln, File.readln docs

[GitHub]

  Branch: refs/heads/master
  Home:   https://github.com/D-Programming-Language/phobos
  Commit: f34b41f33fc8b983e871b482ab6cebf9307fbea9
      https://github.com/D-Programming-Language/phobos/commit/f34b41f33fc8b983e871b482ab6cebf9307fbea9
  Author: Nick Treleaven <nick.treleaven at btinternet.com>
  Date:   2013-07-06 (Sat, 06 Jul 2013)

  Changed paths:
    M std/stdio.d

  Log Message:
  -----------
  Fix & improve readln, File.readln docs

Purge phantom fp parameter.
Add missing parameters and throws info.
Fix File.readln(buf) example to use char[] buf for reuse, not string.
Fix swapped readln() and File.readln() examples.
Separate readln() and readln(buf) docs because the behaviour and
return types are different.


  Commit: f7bec656d254dbc42c925a7c91ed54b90b78915e
      https://github.com/D-Programming-Language/phobos/commit/f7bec656d254dbc42c925a7c91ed54b90b78915e
  Author: Nick Treleaven <nick.treleaven at btinternet.com>
  Date:   2013-07-06 (Sat, 06 Jul 2013)

  Changed paths:
    M std/stdio.d

  Log Message:
  -----------
  Use 'void main' instead of 'int main' in examples


  Commit: e90c141a785b5e058b878d15ff6248deff2a4910
      https://github.com/D-Programming-Language/phobos/commit/e90c141a785b5e058b878d15ff6248deff2a4910
  Author: Nick Treleaven <nick.treleaven at btinternet.com>
  Date:   2013-07-06 (Sat, 06 Jul 2013)

  Changed paths:
    M std/stdio.d

  Log Message:
  -----------
  Change 'is reused' to 'you can reuse' for clarity


  Commit: ad003aa6182e244fc8a897fa8e4dcae25db3b17b
      https://github.com/D-Programming-Language/phobos/commit/ad003aa6182e244fc8a897fa8e4dcae25db3b17b
  Author: Nick Treleaven <nick.treleaven at btinternet.com>
  Date:   2013-07-08 (Mon, 08 Jul 2013)

  Changed paths:
    M std/stdio.d

  Log Message:
  -----------
  Fix note about retaining buffer contents


  Commit: 9e5346049c68d3ec7590775e3ce06653667efa01
      https://github.com/D-Programming-Language/phobos/commit/9e5346049c68d3ec7590775e3ce06653667efa01
  Author: Nick Treleaven <nick.treleaven at btinternet.com>
  Date:   2013-07-08 (Mon, 08 Jul 2013)

  Changed paths:
    M std/stdio.d

  Log Message:
  -----------
  Change File.readln(buf) example not to idup each line

Now lines starting with '#' are ignored.
Lines starting with 'q' no longer end the program.


  Commit: f0f02d70b621aa73a1c02840ac7d6172e87d16b7
      https://github.com/D-Programming-Language/phobos/commit/f0f02d70b621aa73a1c02840ac7d6172e87d16b7
  Author: Nick Treleaven <nick.treleaven at btinternet.com>
  Date:   2013-07-08 (Mon, 08 Jul 2013)

  Changed paths:
    M std/stdio.d

  Log Message:
  -----------
  Simplify File.readln(buf) example using a single output string

This is probably more performant than an array of idup'ped strings.
(Suggested by Steven Schveighoffer).


  Commit: d1bc6ceca0444a6dc313b755732ec55d6586c4bc
      https://github.com/D-Programming-Language/phobos/commit/d1bc6ceca0444a6dc313b755732ec55d6586c4bc
  Author: Steven Schveighoffer <schveiguy at yahoo.com>
  Date:   2013-07-08 (Mon, 08 Jul 2013)

  Changed paths:
    M std/stdio.d

  Log Message:
  -----------
  Merge pull request #1380 from ntrel/stdio-doc-fixes

Fix & improve readln, File.readln docs


Compare: https://github.com/D-Programming-Language/phobos/compare/ecadde6ffd50...d1bc6ceca044