Bug 650162 - man useradd is incorrect
man useradd is incorrect
Product: Red Hat Enterprise Linux 6
Classification: Red Hat
Component: man-pages-overrides (Show other bugs)
All Linux
low Severity medium
: rc
: ---
Assigned To: Ivana Varekova
BaseOS QE - Apps
: ManPageChange
Depends On: 523265
Blocks: 674878
  Show dependency treegraph
Reported: 2010-11-05 08:52 EDT by Alexander Todorov
Modified: 2013-01-10 22:29 EST (History)
7 users (show)

See Also:
Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: 523265
: 674878 (view as bug list)
Last Closed: 2011-05-19 10:28:55 EDT
Type: ---
Regression: ---
Mount Type: ---
Documentation: ---
Verified Versions:
Category: ---
oVirt Team: ---
RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---

Attachments (Terms of Use)
man page fix (542 bytes, patch)
2011-02-09 05:01 EST, Peter Vrabec
no flags Details | Diff

  None (edit)
Description Alexander Todorov 2010-11-05 08:52:55 EDT
+++ This bug was initially created as a clone of Bug #523265 +++

Description of problem:
The man page for useradd command says:

-m --create-home
By default, no home directories are created.

while /etc/login.defs has 


The comments in login.defs make it clear that on RH systems home directories are always created by default. Man page says the opposite.

Version-Release number of selected component (if applicable):

How reproducible:

--- Additional comment from fedora-triage-list@redhat.com on 2009-11-16 14:22:38 EET ---

This bug appears to have been reported against 'rawhide' during the Fedora 12 development cycle.
Changing version to '12'.

More information and reason for this action is here:

--- Additional comment from fedora-triage-list@redhat.com on 2010-11-04 12:02:33 EET ---

This message is a reminder that Fedora 12 is nearing its end of life.
Approximately 30 (thirty) days from now Fedora will stop maintaining
and issuing updates for Fedora 12.  It is Fedora's policy to close all
bug reports from releases that are no longer maintained.  At that time
this bug will be closed as WONTFIX if it remains open with a Fedora 
'version' of '12'.

Package Maintainer: If you wish for this bug to remain open because you
plan to fix it in a currently maintained version, simply change the 'version' 
to a later Fedora version prior to Fedora 12's end of life.

Bug Reporter: Thank you for reporting this issue and we are sorry that 
we may not be able to fix it before Fedora 12 is end of life.  If you 
would still like to see this bug fixed and are able to reproduce it 
against a later version of Fedora please change the 'version' of this 
bug to the applicable version.  If you are unable to change the version, 
please add a comment here and someone will do it for you.

Although we aim to fix as many bugs as possible during every release's 
lifetime, sometimes those efforts are overtaken by events.  Often a 
more recent Fedora release includes newer upstream software that fixes 
bugs or makes them obsolete.

The process we are following is described here: 

--- Additional comment from atodorov@redhat.com on 2010-11-05 14:52:32 EET ---

I think this is still true (at least on RHEL6).
Comment 1 Alexander Todorov 2010-11-05 08:53:33 EDT
Cloning here for RHEL6.
Comment 2 RHEL Product and Program Management 2011-01-07 10:44:06 EST
This request was evaluated by Red Hat Product Management for
inclusion in the current release of Red Hat Enterprise Linux.
Because the affected component is not scheduled to be updated
in the current release, Red Hat is unfortunately unable to
address this request at this time. Red Hat invites you to
ask your support representative to propose this request, if
appropriate and relevant, in the next release of Red Hat
Enterprise Linux. If you would like it considered as an
exception in the current release, please ask your support
Comment 3 Peter Vrabec 2011-02-09 05:01:48 EST
Created attachment 477779 [details]
man page fix
Comment 6 Radek Bíba 2011-04-11 12:40:53 EDT
The changed sentence doesn't look good. It uses "RHEL", which should be avoided, and the overall structure is a bit strange. I guess we could just remove the word "no" and say:

By default, home directories are created.

or use a professional writing style:

useradd will create the home directory unless CREATE_HOME in /etc/login.defs is set to no.

What do you guys think?
Comment 7 Peter Vrabec 2011-04-12 07:37:49 EDT
I prefer: "useradd will create the home directory unless CREATE_HOME in /etc/login.defs is set to no"
Comment 8 Radek Bíba 2011-04-12 08:19:59 EDT
Comment 11 errata-xmlrpc 2011-05-19 10:28:55 EDT
An advisory has been issued which should help the problem
described in this bug report. This report is therefore being
closed with a resolution of ERRATA. For more information
on therefore solution and/or where to find the updated files,
please follow the link below. You may reopen this bug report
if the solution does not work for you.


Note You need to log in before you can comment on or make changes to this bug.