Bug 442056 - Review Request: mono-ndoc - Code Documentation Generator for .NET
Review Request: mono-ndoc - Code Documentation Generator for .NET
Product: Fedora
Classification: Fedora
Component: Package Review (Show other bugs)
All Linux
medium Severity medium
: ---
: ---
Assigned To: Jason Tibbitts
Fedora Extras Quality Assurance
Depends On:
  Show dependency treegraph
Reported: 2008-04-11 10:45 EDT by Tom "spot" Callaway
Modified: 2008-04-11 16:12 EDT (History)
2 users (show)

See Also:
Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of:
Last Closed: 2008-04-11 16:12:39 EDT
Type: ---
Regression: ---
Mount Type: ---
Documentation: ---
Verified Versions:
Category: ---
oVirt Team: ---
RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---
tibbs: fedora‑review+
tcallawa: fedora‑cvs+

Attachments (Terms of Use)

  None (edit)
Description Tom "spot" Callaway 2008-04-11 10:45:21 EDT
Spec URL: http://www.auroralinux.org/people/spot/review/new/mono-ndoc.spec
SRPM URL: http://www.auroralinux.org/people/spot/review/new/mono-ndoc-1.3.1-1.fc9.src.rpm

NDoc generates class library documentation from .NET assemblies and the XML
documentation files generated by the C# compiler. NDoc uses pluggable
documenters to generate documentation in several different formats, including
the MSDN-style HTML Help format (.chm), the Visual Studio .NET Help format
(HTML Help 2), and MSDN-online style web pages.
Comment 1 Jason Tibbitts 2008-04-11 13:33:38 EDT
This one builds OK but needs a couple of fixes:

  mono-ndoc.x86_64: E: no-binary
  mono-ndoc.x86_64: E: only-non-binary-in-usr-lib
The usual mono complaints.

  mono-ndoc-debuginfo.x86_64: E: empty-debuginfo-package
Will need disabling.

  mono-ndoc-devel.x86_64: W: wrong-file-end-of-line-encoding 
  mono-ndoc-devel.x86_64: W: wrong-file-end-of-line-encoding 
  mono-ndoc-devel.x86_64: W: file-not-utf8 
  mono-ndoc-devel.x86_64: W: wrong-file-end-of-line-encoding 
I guess these aren't intended to be displayed, but we generally fix up html
files so I don't really see a reason not to fix these up as well.

Full review in a bit.
Comment 3 Jason Tibbitts 2008-04-11 14:39:43 EDT
rpmlint output is down to:
  mono-ndoc.x86_64: E: no-binary
  mono-ndoc.x86_64: E: only-non-binary-in-usr-lib
both of which are OK.

Everything looks good to me.

* source files match upstream:
* package meets naming and versioning guidelines.
* specfile is properly named, is cleanly written and uses macros consistently.
* summary is OK.
* description is OK.
* dist tag is present.
* build root is OK.
* license field matches the actual license.
* license is open source-compatible.
* license text included in package.
* latest version is being packaged.
* BuildRequires are proper.
* %clean is present.
* package builds in mock (rawhide, x86_64).
* package installs properly.
* rpmlint has acceptable complaints.
* final provides and requires are sane:
   mono(NDoc.Core) = 1.3.3023.0
   mono(NDoc.Documenter.JavaDoc) = 1.3.3023.0
   mono(NDoc.Documenter.Latex) = 1.3.3023.0
   mono(NDoc.Documenter.LinearHtml) = 1.3.3023.0
   mono(NDoc.Documenter.Msdn) = 1.3.3023.0
   mono(NDoc.Documenter.Msdn2) = 1.3.3023.0
   mono(NDoc.Documenter.Xml) = 1.3.3023.0
   mono(NDoc.ExtendedUI) = 1.3.3023.0
   mono(NDoc.Test) = 1.3.3023.0
   mono(NDoc.VisualStudio) = 1.3.3023.0
   mono(NDocConsole) = 1.3.3023.0
   mono-ndoc = 1.3.1-2.fc9
   mono(NDoc.Core) = 1.3.3023.0
   mono(NDoc.ExtendedUI) = 1.3.3023.0
   mono(System) = 1.0.5000.0
   mono(System.Drawing) = 1.0.5000.0
   mono(System.Windows.Forms) = 1.0.5000.0
   mono(System.Xml) = 1.0.5000.0
   mono(mscorlib) = 1.0.5000.0

   mono-ndoc-devel = 1.3.1-2.fc9
   mono-ndoc = 1.3.1-2.fc9

* %check is not present.  As far as I can tell, tests are run at build time.
* owns the directories it creates.
* doesn't own any directories it shouldn't.
* no duplicates in %files.
* file permissions are appropriate.
* no scriptlets present.
* code, not content.
* documentation is all in the -devel package.
* %docs are not necessary for the proper functioning of the package.
* pkgconfig file is in the -devel package.

Comment 4 Tom "spot" Callaway 2008-04-11 15:52:14 EDT
New Package CVS Request
Package Name: mono-ndoc
Short Description: Code Documentation Generator for .NET
Owners: spot
Branches: F-7 F-8 F-9 devel
Cvsextras Commits: yes
Comment 5 Tom "spot" Callaway 2008-04-11 16:03:32 EDT
cvs done.
Comment 6 Tom "spot" Callaway 2008-04-11 16:12:39 EDT
Thanks for the review, its built everywhere.

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