[stdin]
description = 'standard input.'

[stdout]
description = 'standard output.'

[stderr]
description = 'standard error.'

[close]
description = 'Close `file` or default output file.'

[flush]
description = 'Saves any written data to default output file.'

[input]
description = 'Sets `file` as the default input file.'

[lines]
description = [[
------
```lua
for c in io.lines(filename, ...) do
    body
end
```
]]
[[.enums]]
name = 'mode'
enum = 'n'
description = 'Reads a numeral and returns it as number.'
[[.enums]]
name = 'mode'
enum = 'a'
description = 'Reads the whole file.'
[[.enums]]
name = 'mode'
enum = 'l'
description = 'Reads the next line skipping the end of line.'
[[.enums]]
name = 'mode'
enum = 'L'
description = 'Reads the next line keeping the end of line.'
[[.enums]]
name = 'mode'
code = 'number'
description = 'Reads a string with up to this number of bytes.'

[open]
description = 'Opens a file, in the mode specified in the string mode.'
[[.enums]]
name = 'mode'
enum = 'r'
description = 'Read mode.'
[[.enums]]
name = 'mode'
enum = 'w'
description = 'Write mode.'
[[.enums]]
name = 'mode'
enum = 'a'
description = 'Append mode.'
[[.enums]]
name = 'mode'
enum = 'r+'
description = 'Update mode, all previous data is preserved.'
[[.enums]]
name = 'mode'
enum = 'w+'
description = 'Update mode, all previous data is erased.'
[[.enums]]
name = 'mode'
enum = 'a+'
description = 'Append update mode, previous data is preserved, writing is only allowed at the end of file.'

[output]
description = 'Sets `file` as the default output file.'

[popen]
description = 'Starts program prog in a separated process.'
[[.enums]]
name = 'mode'
enum = 'r'
description = 'Read data from this program by `file`.'
[[.enums]]
name = 'mode'
enum = 'w'
description = 'Write data to this program by `file`.'

[read]
description = 'Reads the `file`, according to the given formats, which specify what to read.'
[[.enums]]
name = 'mode'
enum = 'n'
description = 'Reads a numeral and returns it as number.'
[[.enums]]
name = 'mode'
enum = 'a'
description = 'Reads the whole file.'
[[.enums]]
name = 'mode'
enum = 'l'
description = 'Reads the next line skipping the end of line.'
[[.enums]]
name = 'mode'
enum = 'L'
description = 'Reads the next line keeping the end of line.'
[[.enums]]
name = 'mode'
code = 'number'
description = 'Reads a string with up to this number of bytes.'

[tmpfile]
description = 'In case of success, returns a handle for a temporary file.'

[type]
description = 'Checks whether obj is a valid file handle.'
[[.enums]]
name = 'type'
enum = 'file'
description = 'Is an open file handle.'
[[.enums]]
name = 'type'
enum = 'closed file'
description = 'Is a closed file handle.'
[[.enums]]
name = 'type'
code = 'nil'
description = 'Is not a file handle.'

[write]
description = 'Writes the value of each of its arguments to default output file.'