collective.checkdocs adds new distutils commands checkdocs and showdocs to
validate restructured text in long_description field of Python eggs. This
package aims to make Python egg help page publishing and editing easier.
Eggs' long description field, which is usually also the README.txt file of
the package, is reST formatted text. This text is converted to HTML to show on
the package page when package is published in distribution repositories like
PyPI or plone.org. Unfortunately, since repositories do poor job to validate
incoming reST text, errors in the text will result to broken published
package pages.
Unpublishing is usually very cumbersome. We save our time by validating reST
input using checkdocs and showdocs commands before submitting eggs to PyPi.
NOTE: If this package has multiple flavors (see below), then use one of them instead of the name specified above. NOTE: This is a Python port. Instead of py311-collective.checkdocs listed in the above command, you can pick from the names under the Packages section.
python: bump all USE_PYTHON=distutils consumers after RUN_DEPENDS removal
Any missed ports, feel free to bump.
Any ports that need setuptools at runtime can have the devel/py-setuptools
manually added back to RUN_DEPENDS, but understand that this practice
is deprecated; see CHANGES for details.
all: remove explicit versions in USES=python for "3.x+"
The logic in USES=python will automatically convert this to 3.8+ by
itself.
Adjust two ports that only had Python 3.7 mentioned but build fine
on Python 3.8 too.
finance/quickfix: mark BROKEN with PYTHON
libtool: compile: c++ -DHAVE_CONFIG_H -I. -I../.. -I -I. -I.. -I../.. -I../C++
-DLIBICONV_PLUG -DPYTHON_MAJOR_VERSION=3 -Wno-unused-variable
-Wno-maybe-uninitialized -O2 -pipe -DLIBICONV_PLUG -fstack-protector-strong
-fno-strict-aliasing -DLIBICONV_PLUG -Wall -ansi
-Wno-unused-command-line-argument -Wpointer-arith -Wwrite-strings
-Wno-overloaded-virtual -Wno-deprecated-declarations -Wno-deprecated -std=c++0x
-MT _quickfix_la-QuickfixPython.lo -MD -MP -MF
.deps/_quickfix_la-QuickfixPython.Tpo -c QuickfixPython.cpp -fPIC -DPIC -o
.libs/_quickfix_la-QuickfixPython.o
warning: unknown warning option '-Wno-maybe-uninitialized'; did you mean
'-Wno-uninitialized'? [-Wunknown-warning-option]
QuickfixPython.cpp:175:11: fatal error: 'Python.h' file not found
^~~~~~~~~~
1 warning and 1 error generated.
Reviewed by: portmgr, vishwin, yuri
Differential Revision: <https://reviews.freebsd.org/D40568>
Remove WWW entries moved into port Makefiles
Commit b7f05445c00f has added WWW entries to port Makefiles based on
WWW: lines in pkg-descr files.
This commit removes the WWW: lines of moved-over URLs from these
pkg-descr files.
Approved by: portmgr (tcberner)
Add WWW entries to port Makefiles
It has been common practice to have one or more URLs at the end of the
ports' pkg-descr files, one per line and prefixed with "WWW:". These
URLs should point at a project website or other relevant resources.
Access to these URLs required processing of the pkg-descr files, and
they have often become stale over time. If more than one such URL was
present in a pkg-descr file, only the first one was tarnsfered into
the port INDEX, but for many ports only the last line did contain the
port specific URL to further information.
There have been several proposals to make a project URL available as
a macro in the ports' Makefiles, over time.
(Only the first 15 lines of the commit message are shown above )
[NEW] textproc/py-collective.checkdocs: view and validate w/ long_description
collective.checkdocs adds new distutils commands checkdocs and showdocs to
validate restructured text in long_description field of Python eggs. This
package aims to make Python egg help page publishing and editing easier.
Eggs' long description field, which is usually also the README.txt file of
the package, is reST formatted text. This text is converted to HTML to show
on the package page when package is published in distribution repositories
like PyPI or plone.org. Unfortunately, since repositories do poor job to
validate incoming reST text, errors in the text will result to broken
published package pages.
Unpublishing is usually very cumbersome. We save our time by validating reST
input using checkdocs and showdocs commands before submitting eggs to PyPi.
WWW: https://github.com/collective/collective.checkdocs
