[docco] Initial package

Jamie Nguyen jamielinux at fedoraproject.org
Mon Mar 18 18:41:36 UTC 2013


commit 7ac1ba080985b91b7d83d1bc85c2a368de4cfb13
Author: Jamie Nguyen <j at jamielinux.com>
Date:   Mon Mar 18 18:41:24 2013 +0000

    Initial package

 .gitignore |    1 +
 docco.1    |   30 ++++++++++++++++
 docco.spec |  113 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 sources    |    1 +
 4 files changed, 145 insertions(+), 0 deletions(-)
---
diff --git a/.gitignore b/.gitignore
index e69de29..3c8cca7 100644
--- a/.gitignore
+++ b/.gitignore
@@ -0,0 +1 @@
+/docco-0.6.1.tgz
diff --git a/docco.1 b/docco.1
new file mode 100644
index 0000000..99c0047
--- /dev/null
+++ b/docco.1
@@ -0,0 +1,30 @@
+.TH DOCCO "1" "March 2013" "docco 0.6.1" "User Commands"
+.SH NAME
+docco \- The Quick and Dirty Literate Programming Documentation Generator
+.SH SYNOPSIS
+Usage: docco [\fIoptions\fR] <\fIfilePattern\fR> ...
+.SH DESCRIPTION
+Docco is a quick-and-dirty documentation generator, written in Literate CoffeeScript. It produces an HTML document that displays your comments intermingled with your code. All prose is passed through Markdown, and code is passed through Pygments syntax highlighting.
+.SH OPTIONS
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+output usage information
+.TP
+\fB\-V\fR, \fB\-\-version\fR
+output the version number
+.TP
+\fB\-c\fR, \fB\-\-css\fR [file]
+use a custom css file
+.TP
+\fB\-o\fR, \fB\-\-output\fR [path]
+use a custom output path
+.TP
+\fB\-t\fR, \fB\-\-template\fR [file]
+use a custom .jst template
+.SH AUTHORS
+The main author of docco is Jeremy Ashkenas <\fBjashkenas at gmail.com\fR>.
+For a more complete list of contributors, see the GitHub page at
+<\fBhttps://github.com/jashkenas/docco\fR>.
+.SH "REPORTING BUGS"
+Please report bugs on the GitHub issue tracker:
+<\fBhttps://github.com/jashkenas/docco/issues\fR>.
diff --git a/docco.spec b/docco.spec
new file mode 100644
index 0000000..c30dc36
--- /dev/null
+++ b/docco.spec
@@ -0,0 +1,113 @@
+Name:       docco
+Version:    0.6.1
+Release:    2%{?dist}
+Summary:    The Quick and Dirty Literate Programming Documentation Generator
+License:    MIT
+Group:      System Environment/Libraries
+URL:        http://jashkenas.github.com/docco/
+Source0:    http://registry.npmjs.org/docco/-/docco-%{version}.tgz
+# Include our own man page.
+Source20:   docco.1
+BuildArch:  noarch
+
+BuildRequires:  nodejs-devel
+
+# Required for running docco to build the docs.
+BuildRequires:  npm(commander)
+BuildRequires:  npm(highlight.js)
+BuildRequires:  npm(marked)
+BuildRequires:  npm(underscore)
+BuildRequires:  python-pygments
+
+Requires:       python-pygments
+
+%description
+Docco is a quick-and-dirty documentation generator, written in Literate
+CoffeeScript. It produces an HTML document that displays your comments
+intermingled with your code. All prose is passed through Markdown, and
+code is passed through Pygments syntax highlighting.
+
+
+%prep
+%setup -q -n package
+
+
+%build
+cp -pr %{nodejs_sitelib} .
+# Build the documentation.
+./bin/docco --layout linear docco.litcoffee
+# Remove bundled web fonts.
+find . -type f -iname '*.eot' -delete
+find . -type f -iname '*.ttf' -delete
+find . -type f -iname '*.woff' -delete
+
+
+%install
+mkdir -p %{buildroot}%{nodejs_sitelib}/docco
+cp -pr package.json \
+    %{buildroot}%{nodejs_sitelib}/docco
+mkdir -p %{buildroot}%{nodejs_sitelib}/docco/bin
+install -p -D -m0755 bin/docco \
+    %{buildroot}%{nodejs_sitelib}/docco/bin/docco
+mkdir -p %{buildroot}%{_bindir}
+ln -sf %{nodejs_sitelib}/docco/bin/docco \
+    %{buildroot}%{_bindir}/docco
+
+mkdir -p %{buildroot}%{_datadir}/docco
+cp -pr resources/ %{buildroot}%{_datadir}/docco
+ln -sf %{_datadir}/docco/resources \
+    %{buildroot}%{nodejs_sitelib}/docco/resources
+
+# The docs expect the resources/ directory to be present.
+mkdir -p %{buildroot}%{_docdir}/%{name}-%{version}
+ln -sf %{_datadir}/docco/resources \
+    %{buildroot}%{_docdir}/%{name}-%{version}/resources
+
+mkdir -p %{buildroot}%{_mandir}/man1
+install -p -D -m0644 %{SOURCE20} %{buildroot}%{_mandir}/man1/docco.1
+
+%nodejs_symlink_deps
+
+
+%files
+%doc LICENSE README index.html docs/*
+%{nodejs_sitelib}/docco
+%{_bindir}/docco
+%{_datadir}/docco
+%{_mandir}/man1/docco.1*
+
+
+%changelog
+* Sat Mar 16 2013 Jamie Nguyen <jamielinux at fedoraproject.org> - 0.6.1-2
+- rename from nodejs-docco to just docco
+
+* Fri Mar 15 2013 Jamie Nguyen <jamielinux at fedoraproject.org> - 0.6.1-1
+- update to upstream release 0.6.1
+- use LICENSE file that has now been included in the tarball
+- move docs to %%docs
+- remove bundled web fonts
+- include /usr/share/docco/resources
+- add python-pygments to BuildRequires
+- add npm(highlight-js) to BuildRequires
+
+* Tue Mar 12 2013 Jamie Nguyen <jamielinux at fedoraproject.org> - 0.6.0-1
+- update to upstream release 0.6.0
+- remove comments about bundled showdown.js as project has switched to marked
+- add a man page
+- improve %%description
+- remove /usr/share/docco/resources as we are including the compiled version
+- test suite removed by upstream so remove coffee-script, npm(console.log)
+  and python-pygments from BuildRequires
+- add npm(marked) and npm(underscore) to BuildRequires
+
+* Sat Mar 09 2013 Jamie Nguyen <jamielinux at fedoraproject.org> - 0.4.0-4
+- add copies of the MIT and BSD licenses to comply with license requirements
+
+* Sun Feb 17 2013 Jamie Nguyen <jamielinux at fedoraproject.org> - 0.4.0-3
+- add BSD to License
+
+* Sun Feb 17 2013 Jamie Nguyen <jamielinux at fedoraproject.org> - 0.4.0-2
+- include vendor/ directory
+
+* Sun Feb 17 2013 Jamie Nguyen <jamielinux at fedoraproject.org> - 0.4.0-1
+- initial package
diff --git a/sources b/sources
index e69de29..7fc6719 100644
--- a/sources
+++ b/sources
@@ -0,0 +1 @@
+36c8ea73e0d5db794d3d735febdcd2a4  docco-0.6.1.tgz


More information about the scm-commits mailing list