On Sun, 4 Apr 2021 13:30:26 +0200 Bastian Germann <bastiangerm...@fishpost.de>
wrote:
Please add manpages for fw_printenv and fw_setenv. You can base them on the former u-boot-tools'
manpages:
https://manpages.debian.org/buster/u-boot-tools/fw_printenv.8.en.gz
https://manpages.debian.org/buster/u-boot-tools/fw_setenv.8.en.gz
A patch with these is enclosed, including the necessary copyright addition.
From: Bastian Germann <bastiangerm...@fishpost.de>
Date: Wed, 23 Jun 2021 09:15:39 +0200
Subject: Add manpages based on u-boot-tools
Tweak u-boot-tools' former manpages for fw_printenv and fw_setenv and add them.
---
diff --git a/debian/copyright b/debian/copyright
index f4255c4..e81f9d3 100644
--- a/debian/copyright
+++ b/debian/copyright
@@ -10,6 +10,30 @@ Files: debian/*
Copyright: 2019 Nobuhiro Iwamatsu <iwama...@debian.org>
License: LGPL-2.1+
+Files:
+ debian/fw_printenv.8
+ debian/fw_setenv.8
+Copyright:
+ 2008 Per Andersson <avtob...@gmail.com>
+ 2021 Bastian Germann
+License: GPL-2+
+ This program is free software; you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation; either version 2 of the License, or
+ (at your option) any later version.
+ .
+ This program 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 General Public License for more details.
+ .
+ You should have received a copy of the GNU General Public License
+ along with this program; if not, write to the Free Software
+ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
+ .
+ On Debian systems, the complete text of the GNU General Public License
+ version 2 can be found in /usr/share/common-licenses/GPL-2.
+
License: LGPL-2.1+
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as published by
diff --git a/debian/fw_printenv.8 b/debian/fw_printenv.8
new file mode 100644
index 0000000..8b8322b
--- /dev/null
+++ b/debian/fw_printenv.8
@@ -0,0 +1,42 @@
+.\" Copyright © 2008 Per Andersson <avtob...@gmail.com>
+.\" Copyright © 2021 Bastian Germann
+.\" This man page is covered by the GNU General Public License (GPLv2 or higher).
+.TH fw_printenv 8 2021-06-23
+.SH NAME
+fw_printenv \- Tool for printing the environment for the bootloader U-Boot
+.SH SYNOPSIS
+fw_printenv [ \fIname\fP ... ]
+.SH DESCRIPTION
+fw_printenv is a simple tool for printing the environment for the bootloader U-Boot.
+All environment variables matching the names given as arguments are shown.
+If fw_printenv is called without any arguments the entire environment is printed.
+This version of fw_printenv stems from libubootenv and does not hold a built-in default environment.
+Instead, the default environment is read from a file.
+.SH OPTIONS
+.TP
+.TP
+.B -h
+print a help message
+.TP
+.B -c, --config <filename>
+configuration file (old fw_env.config)
+.TP
+.B -f, --defenv <filename>
+default environment if no one found
+.TP
+.B -V
+print program's version
+.TP
+.B -n, --no-header
+do not print variable name
+.SH FILES
+.TP
+.B /etc/fw_env.config
+Configuration file for fw_printenv.
+Default value of the --config option.
+.TP
+.B /etc/u-boot-initial-env
+Default U-Boot environment.
+Default value of the --defenv option.
+.SH SEE ALSO
+fw_setenv(8)
diff --git a/debian/fw_setenv.8 b/debian/fw_setenv.8
new file mode 100644
index 0000000..aa5fd75
--- /dev/null
+++ b/debian/fw_setenv.8
@@ -0,0 +1,41 @@
+.\" Copyright © 2008 Per Andersson <avtob...@gmail.com>
+.\" Copyright © 2021 Bastian Germann
+.\" This man page is covered by the GNU General Public License (GPLv2 or higher).
+.TH fw_setenv 8 2021-06-23
+.SH NAME
+fw_setenv \- Tool for modifying the environment for the bootloader U\-Boot
+.SH SYNOPSIS
+fw_setenv \fIname\fP [ \fIvalue\fP ]
+.SH DESCRIPTION
+fw_setenv is a simple tool for modifying the environment for the bootloader U-Boot.
+The variable \fIname\fP is updated to hold \fIvalue\fP if it is already set in the environment, else it is created and set.
+If only the \fIname\fP argument is given, the corresponding variable is deleted.
+This version of fw_printenv stems from libubootenv and does not hold a built-in default environment.
+Instead, the default environment is read from a file.
+.SH OPTIONS
+.TP
+.B -h
+print a help message
+.TP
+.B -c, --config <filename>
+configuration file (old fw_env.config)
+.TP
+.B -f, --defenv <filename>
+default environment if no one found
+.TP
+.B -V
+print program's version
+.TP
+.B -s, --script <filename>
+read variables to be set from a script
+.SH FILES
+.TP
+.B /etc/fw_env.config
+Configuration file for fw_setenv.
+Default value of the --config option.
+.TP
+.B /etc/u-boot-initial-env
+Default U-Boot environment.
+Default value of the --defenv option.
+.SH SEE ALSO
+fw_printenv(8)
diff --git a/debian/libubootenv-tool.manpages b/debian/libubootenv-tool.manpages
new file mode 100644
index 0000000..dcbdf92
--- /dev/null
+++ b/debian/libubootenv-tool.manpages
@@ -0,0 +1,2 @@
+debian/fw_printenv.8
+debian/fw_setenv.8
