[PATCH 1/4] docs: add man page for xenstore-exists

Juergen Gross posted 4 patches 1 week, 4 days ago
[PATCH 1/4] docs: add man page for xenstore-exists
Posted by Juergen Gross 1 week, 4 days ago
There is no man page for xenstore-exists, add it.

Signed-off-by: Juergen Gross <jgross@suse.com>
---
 docs/man/xenstore-exists.1.pod | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)
 create mode 100644 docs/man/xenstore-exists.1.pod

diff --git a/docs/man/xenstore-exists.1.pod b/docs/man/xenstore-exists.1.pod
new file mode 100644
index 0000000000..c4d9eeecaf
--- /dev/null
+++ b/docs/man/xenstore-exists.1.pod
@@ -0,0 +1,17 @@
+=head1 NAME
+
+xenstore-exists - test Xenstore key to exist
+
+=head1 SYNOPSIS
+
+B<xenstore-exists> I<PATH>
+
+=head1 DESCRIPTION
+
+Tests whether the specified Xenstore I<PATH> is readable and sets
+the exit value accordingly (B<0> if I<PTAH> is readable, B<1> if not).
+
+=head1 BUGS
+
+Send bugs to xen-devel@lists.xenproject.org, see
+https://wiki.xenproject.org/wiki/Reporting_Bugs_against_Xen_Project on how to send bug reports.
-- 
2.53.0
Re: [PATCH 1/4] docs: add man page for xenstore-exists
Posted by Andrew Cooper 1 week, 4 days ago
On 12/03/2026 12:22 pm, Juergen Gross wrote:
> There is no man page for xenstore-exists, add it.
>
> Signed-off-by: Juergen Gross <jgross@suse.com>
> ---
>  docs/man/xenstore-exists.1.pod | 17 +++++++++++++++++
>  1 file changed, 17 insertions(+)
>  create mode 100644 docs/man/xenstore-exists.1.pod
>
> diff --git a/docs/man/xenstore-exists.1.pod b/docs/man/xenstore-exists.1.pod
> new file mode 100644
> index 0000000000..c4d9eeecaf
> --- /dev/null
> +++ b/docs/man/xenstore-exists.1.pod
> @@ -0,0 +1,17 @@
> +=head1 NAME
> +
> +xenstore-exists - test Xenstore key to exist

This is awkward grammar.

I suggest "test whether a Xenstore key exists"

~Andrew
Re: [PATCH 1/4] docs: add man page for xenstore-exists
Posted by Jürgen Groß 1 week, 4 days ago
On 12.03.26 13:31, Andrew Cooper wrote:
> On 12/03/2026 12:22 pm, Juergen Gross wrote:
>> There is no man page for xenstore-exists, add it.
>>
>> Signed-off-by: Juergen Gross <jgross@suse.com>
>> ---
>>   docs/man/xenstore-exists.1.pod | 17 +++++++++++++++++
>>   1 file changed, 17 insertions(+)
>>   create mode 100644 docs/man/xenstore-exists.1.pod
>>
>> diff --git a/docs/man/xenstore-exists.1.pod b/docs/man/xenstore-exists.1.pod
>> new file mode 100644
>> index 0000000000..c4d9eeecaf
>> --- /dev/null
>> +++ b/docs/man/xenstore-exists.1.pod
>> @@ -0,0 +1,17 @@
>> +=head1 NAME
>> +
>> +xenstore-exists - test Xenstore key to exist
> 
> This is awkward grammar.
> 
> I suggest "test whether a Xenstore key exists"

Fine with me.


Juergen