Bug 836727 - Improve docs wrt new-sources vs upload
Summary: Improve docs wrt new-sources vs upload
Keywords:
Status: CLOSED NOTABUG
Alias: None
Product: Fedora
Classification: Fedora
Component: fedpkg
Version: 17
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: ---
Assignee: David Cantrell
QA Contact: Fedora Extras Quality Assurance
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2012-06-30 16:01 UTC by Ville Skyttä
Modified: 2013-01-10 06:51 UTC (History)
1 user (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2012-07-02 20:01:04 UTC
Type: Bug
Embargoed:


Attachments (Terms of Use)

Description Ville Skyttä 2012-06-30 16:01:21 UTC
Man fedpkg, ditto in fedpkg --help:

       fedpkg new-sources [-h] files [files ...]
              Upload new source files

       fedpkg upload [-h] files [files ...]
              Upload source files

For someone who isn't intimately familiar with Fedora package maintenance process, this documentation wrt new-sources vs upload is insufficient and confusing.

"new-sources" behavior of removing existing files from .gitignore and sources (IIRC, it's been a while since I used it) should be documented, and "upload" also uploads new source files, it just appends to the list of existing ones.

Comment 1 Jesse Keating 2012-07-02 20:01:04 UTC
It is documented in the specific help output for each sub command (fedpkg new-sources --help / fedpkg upload --help) as well as the fedpkg man page.


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