Bug 836727

Summary: Improve docs wrt new-sources vs upload
Product: [Fedora] Fedora Reporter: Ville Skyttä <ville.skytta>
Component: fedpkgAssignee: David Cantrell <dcantrell>
Status: CLOSED NOTABUG QA Contact: Fedora Extras Quality Assurance <extras-qa>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 17CC: dcantrell
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2012-07-02 20:01:04 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

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.