man: clarify what can be NULL in an sd_bus_unrefp call

Confusingly, the argument is called 'bus' in all cases. Let's not give people
the idea to call sd_bus_unrefp(NULL).
This commit is contained in:
Zbigniew Jędrzejewski-Szmek 2018-07-27 08:06:07 +02:00
parent cfe8ee463d
commit 2c47fff6d2

View file

@ -48,7 +48,7 @@
<funcprototype> <funcprototype>
<funcdef>void <function>sd_bus_unrefp</function></funcdef> <funcdef>void <function>sd_bus_unrefp</function></funcdef>
<paramdef>sd_bus **<parameter>bus</parameter></paramdef> <paramdef>sd_bus **<parameter>busp</parameter></paramdef>
</funcprototype> </funcprototype>
</funcsynopsis> </funcsynopsis>
</refsynopsisdiv> </refsynopsisdiv>
@ -105,10 +105,12 @@
}</programlisting> }</programlisting>
<para><function>sd_bus_ref()</function>, <para><function>sd_bus_ref()</function> and <function>sd_bus_unref()</function>
<function>sd_bus_unref()</function> and execute no operation if the passed in bus object address is
<function>sd_bus_unrefp()</function> execute no operation if the <constant>NULL</constant>. <function>sd_bus_unrefp()</function> will first
passed in bus object is <constant>NULL</constant>.</para> dereference its argument, which must not be <constant>NULL</constant>, and will
execute no operation if <emphasis>that</emphasis> is <constant>NULL</constant>.
</para>
</refsect1> </refsect1>
<refsect1> <refsect1>