Conary Talk:QuickReference

From rPath Wiki

possible corrections

It seems that I'm not allowed to edit Conary:QuickReference, but I'd still like to report these possible corrections. The results of using <source lang="diff"> are somewhat confusing in this case. To clarify, none of the intended corrections are strict deletions (i.e. they are always followed by a "+" substitution).

 
 In addition to illustrating the use of conary rq --info,
 this example shows how adding a trove name to the command
 restricts the output to just the specified trove (in this
-case, the mx package).
+case, the gaim package).

 
 Use --ls or --lsl to list the files in the trove(s) contained in the changeset file:
 
 $ conary scs imagepile_update.ccs --lsl
-   New -rw-r--r--    1 root     root           45 Sep  7 17:12 /usr/share/pileofimages/imagepile
+   New drw-r--r--    1 root     root           45 Sep  7 17:12 /usr/share/pileofimages/imagepile
...
-   New -rw-r--r--    1 root     root       884673 Sep  7 14:09 /usr/share/pileofimages/newcastle.png
+   New -rw-r--r--    1 root     root       884673 Sep  7 14:09 /usr/share/pileofimages/imagepile/newcastle.png
 
 The output generated by --ls includes the absolute path of the
 files affected by the changeset. The output using --lsl includes
 the same files in long list format plus Mod, New, or Del to
 indicate whether the file has been modified, newly added, or
 deleted. In the example, the changeset would create a new
-directory, delete four files, and add one new file. 
+directory, delete five files, and add one new file. 

Thanks for pointing out what you have found. Because Conary is always developing, this document will not always be as up-to-date as possible and examples may be out of sync on occasion, but anything you find in the meantime is helpful.

Thanks for finding the gaim/mx inconsistency. I have corrected that. I'm not sure where the error is in the --lsl option example, but I have changed the "deleted four files" to "deleted five files" to match the example. --Stef 11:09, 28 November 2006 (EST)

clarifications to possible corrections

Quoting the final example from Conary:QuickReference (in Preformatted text):

# ls /usr/share/pileofimages/
imagepile
# cd /usr/share/pileofimages/imagepile/
# ls
newcastle.png

This implies that:

1. "imagepile" is a directory, so the permissions string for the corresponding --lsl output should be prefixed by a "d"
2. "newcastle.png" exists in the "imagepile" directory and not in its parent; currently, this is not consistent with the --lsl output

The QuickReference aggregates two separate documents with two similar examples that were not meant to be the same example. I apologize that the inconsistency was confusing; I had made some changes to the changeset between capturing the screen text, and I didn't change everything to match. I have adjusted the examples for consistency so they will flow better in the QuickReference. Thanks again for spotting it! --Stef 10:35, 29 November 2006 (EST)

no quickreference

Actually this is a HUGE page ;-) I have printed 21 A4 pages. I think a quick reference should have one or two pages. I suggest we move the content to another page and really try to make this here more condensed? --Vinci 13:06, 25 January 2007 (EST)

Vinci, thanks for your comment. Some others have expressed the same thought, and a Documentation issue has been opened to address it. Issue: DOC-358 Please feel welcome to contribute any comments you would like us to consider. --Stef 13:31, 25 January 2007 (EST)