[Octave-bug-tracker] [bug #52775] PDF user manual uses a backward apostrophe ` in code examples

[Mike Miller]

Follow-up Comment #46, bug #52775 (project octave):

I really think the messages were more consistent with other messages the way
they were. If a user tries to build without bison installed, it needs to be
clear that your build will probably succeed unless you are trying to build
from hg or patching a file or some other measure that usually applies to
developers or packagers.

I think it's helpful for these kinds of missing build tool warnings to be
called out in a block with newlines the way they are now.

When I build on Debian 7 with a bunch of build dependencies missing, I get a
warning summary at the end that looks like this


configure: WARNING: 

I wasn't able to find a suitable style for declaring the api prefix
in a bison input file so I'm disabling bison.

configure: WARNING: 

I wasn't able to find a suitable style for declaring a push-pull
parser in a bison input file so I'm disabling bison.

configure: WARNING: 

I didn't find bison, or the version of bison that I found does not
support all the features that are required, but it's only a problem
if you need to reconstruct parse.cc, which is the case if you're
building from VCS sources.

configure: WARNING: 

I wasn't able to find a version of GNU makeinfo that supports the @sortas
command, but it's only a problem if you need to build the manual, which is
the
case if you're building from VCS sources.

configure: WARNING: 

I didn't find icotool, but it's only a problem if you need to
reconstruct octave-logo.ico, which is the case if you're building from
VCS sources.

configure: WARNING: 

I didn't find rsvg-convert, but it's only a problem if you need to
reconstruct octave-logo-*.png, which is the case if you're building
from VCS sources.

configure: WARNING: sndfile library not found.  The audioinfo, audioread, and
audiowrite functions will be disabled.
configure: WARNING: PortAudio library not found.  The audioplayer,
audiorecorder, and audiodevinfo functions will be disabled.
configure: WARNING: Xft library not found.  OpenGL graphics will not be fully
functional.
configure: WARNING: OSMesa library not found.  Offscreen rendering with OpenGL
will be disabled.
configure: WARNING: Qt libraries not found; disabling Qt GUI
configure: WARNING: AMD library not found.  This will result in some lack of
functionality for sparse matrices.
configure: WARNING: CAMD library not found.  This will result in some lack of
functionality for sparse matrices.
configure: WARNING: COLAMD library not found.  This will result in some lack
of functionality for sparse matrices.
configure: WARNING: CCOLAMD library not found.  This will result in some lack
of functionality for sparse matrices.
configure: WARNING: CHOLMOD library not found.  This will result in some lack
of functionality for sparse matrices.
configure: WARNING: CXSparse library not found.  This will result in some lack
of functionality for sparse matrices.
configure: WARNING: UMFPACK not found.  This will result in some lack of
functionality for sparse matrices.
configure: WARNING: KLU library not found.  This will result in some lack of
functionality for sparse matrices
configure: WARNING: SUNDIALS NVECTOR serial library not found.  Solvers ode15i
and ode15s will be disabled.
configure: WARNING: SUNDIALS IDA library not found.  Solvers ode15i and ode15s
will be disabled.
configure: WARNING: JAVA_HOME environment variable not initialized. 
Auto-detection will proceed but is unreliable.
configure: WARNING: No Java executable found.  Octave will not be able to call
Java methods.
configure: WARNING: building documentation disabled because makeinfo was not
found; make dist will fail
configure: 
configure: NOTE: Libraries or auxiliary programs may be skipped if they are
configure: NOTE: not found OR if they are missing required features on your
configure: NOTE: system. 


If at some point we think these kinds of called out warning messages are no
longer necessary then we should change them all consistently. But for now I
think it's important to keep the makeinfo warnings looking the same as all the
rest.

    _______________________________________________________

Reply to this item at:

  <http://savannah.gnu.org/bugs/?52775>

_______________________________________________
  Message sent via/by Savannah
  http://savannah.gnu.org/