MUQ5ZH: Today http://drsm79.github.io/situp/ saying "Once you have it build
the documentation" 1st referred me to Sphinx <http://Sphinx-doc.org>; and
with me unfortunately still on Windows instead of Linux, to install it I
just 1st
tried http://tach.github.io/sphinx.html#installing-sphinx-into-cygwin (and
using latest software, all updated as today else days ago); and it seems
likely to have worked, except:
1. MUQ7XQ: "pip install Sphinx" gave me concerns in its output, quote:
:
Running setup.py egg_info for package Jinja2
*warning: no files found matching '*' under directory 'custom_fixers'
warning: no previously-included files matching '*' found under directory
'do cs/_build'
warning: no previously-included files matching '*.pyc' found under
directory 'jinja2'
warning: no previously-included files matching '*.pyc' found under
directory 'docs'
warning: no previously-included files matching '*.pyo' found under
directory 'jinja2'
warning: no previously-included files matching '*.pyo' found under
directory 'docs'*
Downloading/unpacking docutils>=0.7 (from Sphinx)
:
Running setup.py egg_info for package docutils
*warning: no files found matching 'MANIFEST'
warning: no files found matching '*' under directory 'extras'
warning: no previously-included files matching '.cvsignore' found under
dire ctory '*'
warning: no previously-included files matching '*.pyc' found under
directory '*'
warning: no previously-included files matching '*~' found under
directory '* '
warning: no previously-included files matching '.DS_Store' found under
direc tory '*'*
Downloading/unpacking markupsafe (from Jinja2>=2.3->Sphinx)
:
Running setup.py install for Sphinx
*/usr/lib/python2.7/distutils/dist.py:267: UserWarning: Unknown
distribution option: 'use_2to3'
warnings.warn(msg)
/usr/lib/python2.7/distutils/dist.py:267: UserWarning: Unknown
distribution option: 'use_2to3_fixers'
warnings.warn(msg) *
no previously-included directories found matching 'doc/_build'
:
Running setup.py install for Jinja2
*warning: no files found matching '*' under directory 'custom_fixers'
warning: no previously-included files matching '*' found under directory
'do cs/_build'
warning: no previously-included files matching '*.pyc' found under
directory 'jinja2'
warning: no previously-included files matching '*.pyc' found under
directory 'docs'
warning: no previously-included files matching '*.pyo' found under
directory 'jinja2'
warning: no previously-included files matching '*.pyo' found under
directory 'docs'*
Running setup.py install for docutils
:
changing mode of build/scripts-2.7/rst2odt_prepstyles.py from 644 to 755
*warning: no files found matching 'MANIFEST'
warning: no files found matching '*' under directory 'extras'
warning: no previously-included files matching '.cvsignore' found under
dire ctory '*'
warning: no previously-included files matching '*.pyc' found under
directory '*'
warning: no previously-included files matching '*~' found under
directory '* '
warning: no previously-included files matching '.DS_Store' found under
direc tory '*'
*changing mode of /usr/bin/rst2html.py to 755
:
building 'markupsafe._speedups' extension
gcc -fno-strict-aliasing -ggdb -O2 -pipe
-fdebug-prefix-map=/usr/src/ports/p
ython/python-2.7.5-3/build=/usr/src/debug/python-2.7.5-3
-fdebug-prefix-map=/usr
/src/ports/python/python-2.7.5-3/src/Python-2.7.5=/usr/src/debug/python-2.7.5-3
-DNDEBUG -g -fwrapv -O3 -Wall -Wstrict-prototypes -I/usr/include/python2.7
-c ma rkupsafe/_speedups.c -o
build/temp.cygwin-1.7.25-x86_64-2.7/markupsafe/_speedups .o
*unable to execute gcc: No such file or directory*
==========================================================================
WARNING: The C extension could not be compiled, speedups are not enabled.
Failure information, if any, is above.
Retrying the build without the C extension now.
==========================================================================
WARNING: The C extension could not be compiled, speedups are not enabled.
Plain-Python installation succeeded.
==========================================================================
Successfully installed Sphinx Pygments Jinja2 docutils markupsafe
Cleaning up...
1. MUQ6IK: So
1. I went back to Cygwin setup.exe and added gcc: unfortunately
just "gcc" is not listed, so I picked the seeming best match:
"cygwin32-gcc-g++
..[version] 4.7.3-1" (internal step MUQ5F3), seeing the "gcc" error.
2. I ran "Cygwin 64 Terminal.Run as Administrator" instead of a
normal user (internal step MUQ5Q9), especially seeing the "chown" log
entries
2. MUQ6VQ: Then I redid
http://tach.github.io/sphinx.html#installing-sphinx-into-cygwin
(except as it suggested when trying that,
also did "pip install Sphinx --upgrade" and "python ez_setup.py -U
setuptools") and only got 1 concern:
:
Running setuptools-1.1.6/setup.py -q bdist_egg --dist-dir
/tmp/easy_install-mNKgi2/setuptools-1.1.6/egg-dist-tmp-yYAIcK
*/usr/lib/python2.7/distutils/dist.py:267: UserWarning: Unknown
distribution option: 'src_root'
warnings.warn(msg)
*Removing setuptools 0.6c11 from easy-install.pth file
:
3. MUQ7FP: And think this fixed that as when I reran my document
rebuild, I got an error with it which I'M-GUESSING is from it
http://drsm79.github.io/situp and not Sphinx, quote:
$USER@$HOSTNAME ~/$USER/Documents/Downloads/situp/docs
$ *date&& make html*
Tue, Oct 15, 2013 12:19:22 PM
sphinx-build -b html -d web-docs/situp/doctrees -c docs docs
web-docs/situp/html
*process_begin: CreateProcess(NULL, python2.7
C:\cygwin64\bin\sphinx-build -b html -d web-docs/situp/doctrees -c docs
docs web-docs/situp/html, ...) failed.
make (e=2): The system cannot find the file specified.
make: *** [html] Error 2 *
4. MUQ7BB: *Please
update http://tach.github.io/sphinx.html#installing-sphinx-into-cygwin
and
(if at all possible) the programs it tells the reader to run
so these errors and warnings are not produced else the reader will
knows which of them can be safely dismissed.*
Asides:
- MFB0S5: What are these codes as “MFB0S5” on this paragraph? They're short
IDs to date-stamp, uniquely-reference, and portably-track most any point or
item <http://1.jothere.com/6mp>.
--
You received this message because you are subscribed to the Google Groups
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/groups/opt_out.
