Document toString better

This commit is contained in:
Linus Heckemann 2017-02-19 18:54:18 +00:00
parent 302386f775
commit b8564987a3

View file

@ -1023,10 +1023,18 @@ in foo</programlisting>
<listitem><para>Convert the expression <listitem><para>Convert the expression
<replaceable>e</replaceable> to a string. <replaceable>e</replaceable> to a string.
<replaceable>e</replaceable> can be a string (in which case <replaceable>e</replaceable> can be:
<function>toString</function> is a no-op), a path (e.g., <itemizedlist>
<literal>toString /foo/bar</literal> yields <listitem>a string (in which case the string is returned unmodified)</listitem>
<literal>"/foo/bar"</literal> or a set containing <literal>{ __toString = self: ...; }</literal>.</para></listitem> <listitem>a path (e.g., <literal>toString /foo/bar</literal> yields <literal>"/foo/bar"</literal></listitem>
<listitem>a set containing <literal>{ __toString = self: ...; }</literal></listitem>
<listitem>an integer</listitem>
<listitem>a list, in which case the string representations of its elements are joined with spaces</listitem>
<listitem>a boolean (<literal>false</literal> yields <literal>""</literal>, <literal>true</literal> yields <literal>"1"</literal></listitem>
<listitem><literal>null</literal>, which yields the empty string.</listitem>
</itemizedlist>
</para>
</listitem>
</varlistentry> </varlistentry>