* configure.in: SHADOWGRP added to AM_CONDITIONAL for the

generation of manpages.
* man/generate_translations.mak: Added pam/no_pam condition (like
  in man/Makefile.am).
* man/Makefile.am, man/generate_translations.mak: Added
  gshadow/no_gshadow condition.
* man/gpasswd.1.xml: Use the gshadow/no_gshadow condition to
  change the manpage depending on the shadow group support.
This commit is contained in:
nekral-guest 2007-11-22 21:36:38 +00:00
parent 905596ced5
commit b2c58c81ed
5 changed files with 78 additions and 18 deletions

View File

@ -1,3 +1,14 @@
2007-11-22 Nicolas François <nicolas.francois@centraliens.net>
* configure.in: SHADOWGRP added to AM_CONDITIONAL for the
generation of manpages.
* man/generate_translations.mak: Added pam/no_pam condition (like
in man/Makefile.am).
* man/Makefile.am, man/generate_translations.mak: Added
gshadow/no_gshadow condition.
* man/gpasswd.1.xml: Use the gshadow/no_gshadow condition to
change the manpage depending on the shadow group support.
2007-11-22 Nicolas François <nicolas.francois@centraliens.net>
* po/ru.po: Updated to 399t. Thanks to Yuri Kozlov <kozlov.y@gmail.com>.

View File

@ -240,6 +240,7 @@ AC_SEARCH_LIBS(gethostbyname, nsl)
if test "$enable_shadowgrp" = "yes"; then
AC_DEFINE(SHADOWGRP, 1, [Define to support the shadow group file.])
fi
AM_CONDITIONAL(SHADOWGRP, test "x$enable_shadowgrp" = "xyes")
if test "$enable_man" = "yes"; then
dnl

View File

@ -119,10 +119,15 @@ PAM_COND=pam
else
PAM_COND=no_pam
endif
TUTU_COND=tutu
if SHADOWGRP
SHADOWGRP_COND=gshadow
else
SHADOWGRP_COND=no_gshadow
endif
%: %.xml
$(XSLTPROC) --stringparam profile.condition "$(PAM_COND);$(TUTU_COND)" \
$(XSLTPROC) --stringparam profile.condition "$(PAM_COND);$(SHADOWGRP_COND)" \
-nonet http://docbook.sourceforge.net/release/xsl/current/manpages/profile-docbook.xsl $<
grpconv.8 grpunconv.8 pwunconv.8: pwconv.8

View File

@ -6,8 +6,20 @@ LANG=$(notdir $(CURDIR))
xml2po -l $(LANG) -p $(LANG).po -o $@ ../$@
sed -i 's:\(^<refentry .*\)>:\1 lang="$(LANG)">:' $@
if USE_PAM
PAM_COND=pam
else
PAM_COND=no_pam
endif
if SHADOWGRP
SHADOWGRP_COND=gshadow
else
SHADOWGRP_COND=no_gshadow
endif
%: %.xml
$(XSLTPROC) -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $<
$(XSLTPROC) --stringparam profile.condition "$(PAM_COND);$(SHADOWGRP_COND)" \
-nonet http://docbook.sourceforge.net/release/xsl/current/manpages/profile-docbook.xsl $<
grpconv.8 grpunconv.8 pwunconv.8: pwconv.8

View File

@ -8,7 +8,12 @@
</refmeta>
<refnamediv id='name'>
<refname>gpasswd</refname>
<refpurpose>administer the <filename>/etc/group</filename> file</refpurpose>
<refpurpose>
administer the <filename>/etc/group</filename>
<phrase condition="gshadow">and <filename>/etc/gshadow</filename>
files</phrase>
<phrase condition="no_gshadow">file</phrase>
</refpurpose>
</refnamediv>
<!-- body begins here -->
<refsynopsisdiv id='synopsis'>
@ -26,18 +31,27 @@
<refsect1 id='description'>
<title>DESCRIPTION</title>
<para>
The <command>gpasswd</command> command is used to administer the
<filename>/etc/group</filename> file (and
<filename>/etc/gshadow</filename> file if compiled with SHADOWGRP
defined). Every group can have administrators, members and a password.
The <command>gpasswd</command> command is used to administer
<filename>/etc/group</filename><phrase condition="gshadow">,
and <filename>/etc/gshadow</filename></phrase>.
Every group can have
<phrase condition="gshadow">administrators,</phrase>
members and a password.
</para>
<para condition="gshadow">
System administrator can use the <option>-A</option> option to define
group administrator(s) and the <option>-M</option> option to define
members and has all rights of group administrators and members.
</para>
<para>
<command>gpasswd</command> called by a group administrator with a group
name only prompts for the group password. If a password is set the
members can still <citerefentry>
<command>gpasswd</command> called by
<phrase condition="gshadow">a group administrator</phrase>
<phrase condition="no_gshadow">a system administrator</phrase>
with a group name only prompts for the new password of the
<replaceable>group</replaceable>.
</para>
<para>
If a password is set the members can still <citerefentry>
<refentrytitle>newgrp</refentrytitle><manvolnum>1</manvolnum>
</citerefentry> without a password, and non-members must supply the
password.
@ -56,9 +70,14 @@
<refsect1 id='options'>
<title>OPTIONS</title>
<para>
<para condition="gshadow">
Except for the <option>-A</option> and <option>-M</option> options,
the options cannot be combined.
</para>
<para condition="no_gshadow">
The options cannot be combined.
</para>
<para>
The options which apply to the <command>gpasswd</command> command are:
</para>
<variablelist remap='IP'>
@ -117,7 +136,7 @@
</listitem>
</varlistentry>
</variablelist>
<variablelist remap='IP'>
<variablelist remap='IP' condition="gshadow">
<varlistentry>
<term>
<option>-A</option> <replaceable>user</replaceable>,...
@ -143,6 +162,18 @@
</variablelist>
</refsect1>
<refsect1 id='caveats'>
<title>CAVEATS</title>
<para>
This tool only operates on the <filename>/etc/group</filename>
<phrase condition="gshadow"> and <filename>/etc/gshadow</filename>
files.</phrase>
<phrase condition="no_gshadow">file.</phrase>
Thus you cannot change any NIS or LDAP group. This must be performed
on the corresponding server.
</para>
</refsect1>
<refsect1 id='files'>
<title>FILES</title>
<variablelist>
@ -152,7 +183,7 @@
<para>Group account information.</para>
</listitem>
</varlistentry>
<varlistentry>
<varlistentry condition="gshadow">
<term><filename>/etc/gshadow</filename></term>
<listitem>
<para>Secure group account information.</para>
@ -167,9 +198,6 @@
<citerefentry>
<refentrytitle>newgrp</refentrytitle><manvolnum>1</manvolnum>
</citerefentry>,
<citerefentry>
<refentrytitle>gshadow</refentrytitle><manvolnum>5</manvolnum>
</citerefentry>,
<citerefentry>
<refentrytitle>groupadd</refentrytitle><manvolnum>8</manvolnum>
</citerefentry>,
@ -184,7 +212,10 @@
</citerefentry>,
<citerefentry>
<refentrytitle>group</refentrytitle><manvolnum>5</manvolnum>
</citerefentry>.
</citerefentry><phrase condition="gshadow">,
<citerefentry>
<refentrytitle>gshadow</refentrytitle><manvolnum>5</manvolnum>
</citerefentry></phrase>.
</para>
</refsect1>
</refentry>