Bug 771425

Summary:	Update migration examples with additional options
Product:	Red Hat Enterprise Linux 6	Reporter:	Deon Ballard <dlackey>
Component:	doc-Identity_Management_Guide	Assignee:	Deon Ballard <dlackey>
Status:	CLOSED CURRENTRELEASE	QA Contact:	ecs-bugs
Severity:	medium	Docs Contact:
Priority:	unspecified
Version:	6.2	CC:	jgalipea, jskeoch, mkosek
Target Milestone:	rc	Keywords:	Documentation
Target Release:	6.3
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:	761080	Environment:
Last Closed:	2012-06-27 13:28:08 UTC	Type:	---
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Bug Depends On:	761080
Bug Blocks:

Description Deon Ballard 2012-01-03 17:47:29 UTC

+++ This bug was initially created as a clone of Bug #761080 +++

Description of problem:
Ipa help for migration is incomplete.  The available options are not defined like all other help (no "Options:" section)

The examples shown do not use all the switches.  I know of one ... "--schema" that is not used.

I do not know if there are any other switches that exist that are missing in the example because all available are not ...

The help page should follow the convention of all other CLIs ..

Purpose:
Usage:
Options:
Examples:

Also, it very confusing that the help topics list "migration" and the command to run in the help is not migration but "migrate-ds" ... another inconsistency with the other CLIs.

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


How reproducible:


Steps to Reproduce:
1. ipa help migration
2.
3.
  
Actual results:


Expected results:


Additional info:

--- Additional comment from mkosek on 2011-12-08 03:10:03 EST ---

Upstream ticket:
https://fedorahosted.org/freeipa/ticket/2174

Comment 3 Deon Ballard 2012-06-22 20:11:33 UTC

Fixed typo:

http://docs.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/6/html/Identity_Management_Guide/using-migrate-ds.html

Spellchecking is the last thing I do before GA.

Comment 4 John Skeoch 2012-06-27 00:38:48 UTC

Verified in:

http://docs.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/6/html-single/Identity_Management_Guide/index.html

Red_Hat_Enterprise_Linux-Identity_Management_Guide-6-en-US-2.2.0-0.9

---