[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [PATCH v2 4/8] docs: add man page for xenstore-rm


  • To: Juergen Gross <jgross@xxxxxxxx>, xen-devel@xxxxxxxxxxxxxxxxxxxx
  • From: Andrew Cooper <andrew.cooper3@xxxxxxxxxx>
  • Date: Thu, 12 Mar 2026 15:58:18 +0000
  • Arc-authentication-results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=citrix.com; dmarc=pass action=none header.from=citrix.com; dkim=pass header.d=citrix.com; arc=none
  • Arc-message-signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=EZbWXyvBuykD8oq86koLhFGcDhNU9YbXOw0H9aSp3RM=; b=dv7m/gwir0JnOSfFGMKDx4qExVagEA6i4Tm5ezznRWreMqA5lXxzOHFXU5zQbt5rzTQXatkCvxAJ0Wl71EEhVjwsVgEE238Z0bBjONW1UW2XIfkuOv+NjSfyo9DzHtehaFRVCk9B1bxyHJeFr/YU3G1rrPjX7YcHnlfKALRkYTN9n6rgNTi6pS/zFGLNq8Q+D1ecSHT/p5t78U/gZuS0YALUtiLDiCahQvwJmKN1JJ95UFHWLqUDKDNvqc+sKKEoyWbwzS8ltDnt10QKcIkCuq01F0F/SWX6mH5yGlA0UL1tyK514zgwcLXLjcrDXlto4hcpOOe2vF7ukMabkvXfyg==
  • Arc-seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=nU872e6YYWED9TeegPUm6RfZEhBDAnRO4mNxQqiM61S6c2gdR5m5BQ2alQ0eCKSFrF9HHgZjwmzTB32MEiD/MPzDeCnVYllIOUt5HeQUlMEoXsqf2pfGfFqdvVzrJC5hpFVlk9/fNM6m49VcthfFugkvfZExsrgeQ/sPCc5beyXJxovloA1nsI9U2JnJ7WHi/MRlMLK5mPa3LQmgLdVdueo6TvdpbqKNG0WViLdVP0L+lIba0W1oVGcYzFpB+9B8ZHqYFt4CHY225tguWOPR7BhLnBBbJJssdg7gJF8E/OPV2DWXZjU6wC77ny/V8i/2pw72h0ppKO20ttyU+ARWtw==
  • Authentication-results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=citrix.com;
  • Cc: Andrew Cooper <andrew.cooper3@xxxxxxxxxx>, Anthony PERARD <anthony.perard@xxxxxxxxxx>
  • Delivery-date: Thu, 12 Mar 2026 15:58:35 +0000
  • List-id: Xen developer discussion <xen-devel.lists.xenproject.org>

On 12/03/2026 3:50 pm, Juergen Gross wrote:
> diff --git a/docs/man/xenstore-rm.1.pod b/docs/man/xenstore-rm.1.pod
> new file mode 100644
> index 0000000000..40e3e581eb
> --- /dev/null
> +++ b/docs/man/xenstore-rm.1.pod
> @@ -0,0 +1,28 @@
> +=head1 NAME
> +
> +xenstore-rm - remove Xenstore keys
> +
> +=head1 SYNOPSIS
> +
> +B<xenstore-rm> [I<OPTION>]... [I<PATH>]...
> +
> +=head1 DESCRIPTION
> +
> +Remove one or more Xenstore B<PATH>s.
> +
> +=over
> +
> +=item B<-h>
> +
> +Show the usage information for xenstore-rm and exit the program.
> +
> +=item B<-t>
> +
> +Tidy up Xenstore keys which got all children removed.

Sorry for not spotting this before.  "which had all".

Also it occurs to me that "Tidy up" is not sufficiently close to
delete/remove for the behaviour to be apparent to everyone.  Perhaps
"Tidy up (i.e. remove) Xenstore ..."  ?

The phrase "Tidy up" does need to stay at the start of the sentence
because otherwise there's no hope of knowing what -t stands for.

~Andrew



 


Rackspace

Lists.xenproject.org is hosted with RackSpace, monitoring our
servers 24x7x365 and backed by RackSpace's Fanatical Support®.