[Libguestfs] [nbdkit PATCH v3 1/2] docs: improve documentation of nbdkit_absolute_path
Eric Blake
eblake at redhat.com
Tue Apr 17 15:35:11 UTC 2018
On 04/12/2018 07:44 AM, Pino Toscano wrote:
> Mention what it really does, and where it can only be used.
>
> Signed-off-by: Pino Toscano <ptoscano at redhat.com>
> ---
> docs/nbdkit-plugin.pod | 7 ++++++-
> 1 file changed, 6 insertions(+), 1 deletion(-)
>
> diff --git a/docs/nbdkit-plugin.pod b/docs/nbdkit-plugin.pod
> index 65f3190..27a885e 100644
> --- a/docs/nbdkit-plugin.pod
> +++ b/docs/nbdkit-plugin.pod
> @@ -273,7 +273,12 @@ descriptor.
> char *nbdkit_absolute_path (const char *filename);
>
> The utility function C<nbdkit_absolute_path> converts any path to an
> -absolute path.
> +absolute path: if it is relative, then all this function does is
> +prepending the current working directory to the path, with no extra
s/prepending/prepend/
> +checks.
> +
> +Note that this function works I<only> when used in the C<.config>, and
> +C<.config_complete> callbacks.
>
> If conversion was not possible, this calls C<nbdkit_error> and returns
> C<NULL>. Note that this function does not check that the file exists.
>
--
Eric Blake, Principal Software Engineer
Red Hat, Inc. +1-919-301-3266
Virtualization: qemu.org | libvirt.org
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 619 bytes
Desc: OpenPGP digital signature
URL: <http://listman.redhat.com/archives/libguestfs/attachments/20180417/60386333/attachment.sig>
More information about the Libguestfs
mailing list