Bug 651903

Summary: getent -s not in manual page
Product: [openSUSE] openSUSE 11.3 Reporter: Christopher Yeleighton <giecrilj>
Component: DevelopmentAssignee: Michael Matz <matz>
Status: RESOLVED UPSTREAM QA Contact: E-mail List <qa-bugs>
Severity: Minor    
Priority: P5 - None CC: pth
Version: Final   
Target Milestone: ---   
Hardware: x86-64   
OS: openSUSE 11.3   
Whiteboard:
Found By: --- Services Priority:
Business Priority: Blocker: ---
Marketing QA Status: --- IT Deployment: ---

Description Christopher Yeleighton 2010-11-07 00:28:43 UTC
User-Agent:       Mozilla/5.0 (X11; U; Linux x86_64; pl-PL; rv:1.9.2.12) Gecko/20101026 SUSE/3.6.12-0.7.1 Ant.com Toolbar 2.0.1 Firefox/3.6.12

The manual page for getent is missing important information.

Reproducible: Always

Steps to Reproduce:
  1. getent -h
  2. man getent

Actual Results:  
  1.
  -s, --service=CONFIG       Użycie tej konfiguracji usługi rozwiązywania
                             nazw
  -?, --help                 Wyświetlenie tego tekstu pomocy
      --usage                Wyświetlenie krótkiej informacji o składni
                             polecenia
  -V, --version              Wyświetlenie wersji programu


Expected Results:  
  2.  
    * 
Supported command line options should be documented.
    * 
Relevant environment variables should be mentioned (in particular, $HOSTALIASES).
Comment 1 Philipp Thomas 2010-11-09 17:23:57 UTC
Please report such bugs upstream to the glibc developers. And in the future please use 'LANG=C <command>' to get the help in English.
Comment 2 Christopher Yeleighton 2010-11-10 08:20:23 UTC
A vendor recommendation is required for reporting bugs upstream to the glibc developers.  A separate recommendation is required for each bug reported, unless the reporter is also a maintainer.
I did not use LANG=C this time because the relevant part of the help text is in C anyway.
Comment 4 Philipp Thomas 2011-06-06 14:00:16 UTC
The documentation format of choice for glibc in libc.info. If the texinfo documentation is lacking, please report it upstream. You don't need a recommendation for that.