Hi, please consider the attached bootctl man page to fix RHBZ#1014303. As a bonus I'm also attaching zsh completion rules for bootctl.
Cheers, -- Marko Myllynen
>From 02399073f22fcdaf1af7f36fc5494fb12ba045a7 Mon Sep 17 00:00:00 2001 From: Marko Myllynen <[email protected]> Date: Tue, 12 Nov 2013 17:10:17 +0200 Subject: [PATCH 1/2] Add bootctl zsh completion --- shell-completion/zsh/_bootctl | 25 +++++++++++++++++++++++++ 1 files changed, 25 insertions(+), 0 deletions(-) create mode 100644 shell-completion/zsh/_bootctl diff --git a/shell-completion/zsh/_bootctl b/shell-completion/zsh/_bootctl new file mode 100644 index 0000000..d75fc5e --- /dev/null +++ b/shell-completion/zsh/_bootctl @@ -0,0 +1,25 @@ +#compdef bootctl + +(( $+functions[_bootctl_command] )) || _bootctl_command() +{ + local -a _bootctl_cmds + _bootctl_cmds=( + "status:Show current firmware and boot settings" + ) + if (( CURRENT == 1 )); then + _describe -t commands 'bootctl command' _bootctl_cmds || compadd "$@" + else + local curcontext="$curcontext" + cmd="${${_bootctl_cmds[(r)$words[1]:*]%%:*}}" + if (( $+functions[_bootctl_$cmd] )); then + _bootctl_$cmd + else + _message "no more options" + fi + fi +} + +_arguments \ + {-h,--help}'[Prints a short help text and exits.]' \ + '--version[Prints a short version string and exits.]' \ + '*::bootctl command:_bootctl_command' -- 1.7.1
>From 4393d0784d350bee945acf124f09dd8637603287 Mon Sep 17 00:00:00 2001 From: Marko Myllynen <[email protected]> Date: Tue, 12 Nov 2013 17:38:07 +0200 Subject: [PATCH 2/2] Add bootctl man page --- man/bootctl.xml | 125 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 files changed, 125 insertions(+), 0 deletions(-) create mode 100644 man/bootctl.xml diff --git a/man/bootctl.xml b/man/bootctl.xml new file mode 100644 index 0000000..4dbe701 --- /dev/null +++ b/man/bootctl.xml @@ -0,0 +1,125 @@ +<?xml version='1.0'?> <!--*-nxml-*--> +<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" + "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd";> + +<!-- + This file is part of systemd. + + systemd is free software; you can redistribute it and/or modify it + under the terms of the GNU Lesser General Public License as published by + the Free Software Foundation; either version 2.1 of the License, or + (at your option) any later version. + + systemd is distributed in the hope that it will be useful, but + WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Lesser General Public License for more details. + + You should have received a copy of the GNU Lesser General Public License + along with systemd; If not, see <http://www.gnu.org/licenses/>. +--> + +<refentry id="bootctl" conditional='ENABLE_EFI'> + + <refentryinfo> + <title>bootctl</title> + <productname>systemd</productname> + + <authorgroup> + <author> + <contrib>Developer</contrib> + <firstname>Kay</firstname> + <surname>Sievers</surname> + <email>[email protected]</email> + </author> + </authorgroup> + </refentryinfo> + + <refmeta> + <refentrytitle>bootctl</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>bootctl</refname> + <refpurpose>Control the firmware and boot manager settings</refpurpose> + </refnamediv> + + <refsynopsisdiv> + <cmdsynopsis> + <command>bootctl</command> + <arg choice="opt" rep="repeat">OPTIONS</arg> + <arg choice="req">COMMAND</arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1> + <title>Description</title> + + <para><command>bootctl</command> may be used to + query or (in the future) change the firmware and boot + manager settings.</para> + + <para>Firmware information is available only on EFI + systems.</para> + + <para>Currently, only the <citerefentry><refentrytitle>gummiboot</refentrytitle><manvolnum>8</manvolnum></citerefentry> boot + manager implements the required boot loader interface + to provide complete boot manager information.</para> + </refsect1> + + <refsect1> + <title>Options</title> + + <para>The following options are understood:</para> + + <variablelist> + <varlistentry> + <term><option>-h</option></term> + <term><option>--help</option></term> + + <listitem><para>Prints a short help + text and exits.</para></listitem> + </varlistentry> + + <varlistentry> + <term><option>--version</option></term> + + <listitem><para>Prints a short version + string and exits.</para></listitem> + </varlistentry> + </variablelist> + + <para>The following commands are understood:</para> + + <variablelist> + <varlistentry> + <term><command>status</command></term> + + <listitem><para>Show firmware and boot + manager information about the system, + including secure boot mode status and + selected firmware entry (where + available).</para></listitem> + </varlistentry> + </variablelist> + + </refsect1> + + <refsect1> + <title>Exit status</title> + + <para>On success, 0 is returned, a non-zero failure + code otherwise.</para> + </refsect1> + + <refsect1> + <title>See Also</title> + <para> + <ulink url="http://www.freedesktop.org/wiki/Software/systemd/BootLoaderInterface";>Boot loader interface</ulink> + <ulink url="http://www.freedesktop.org/wiki/Specifications/BootLoaderSpec";>Boot loader specification</ulink> + <ulink url="http://www.freedesktop.org/wiki/Software/gummiboot/";>gummiboot</ulink> + </para> + </refsect1> + +</refentry> -- 1.7.1
_______________________________________________ systemd-devel mailing list [email protected] http://lists.freedesktop.org/mailman/listinfo/systemd-devel
