27 Commits

Author SHA1 Message Date
Erik Auerswald 2026f39ee7 INSTALL: tweak prerequisites list 2023-05-21 18:45:08 +02:00
Erik Auerswald 73e7a69b4c INSTALL: mention (GNU) make as prerequisite 2023-05-20 19:37:29 +02:00
Erik Auerswald f25047745d INSTALL: mention gcc and man under prerequisites 2023-05-20 16:58:38 +02:00
Erik Auerswald 1fe392c772 use latest release date as man page date
The latest release date is extracted from the NEWS file,
i.e., it depends only on the sources, not the build date.
This is intended to help in creating reproducible builds
by avoiding timestamps.  It is also closer to the date of
the contents of the man page than using just the latest
copyright year.

I do not have a perfect solution that works for both a git
clone and a downloaded tar ball.  This solution works well
for released tar balls of the ssocr sources.
2023-05-14 17:37:48 +02:00
Erik Auerswald c6e09b8f70 INSTALL, README: add commas around "e.g." 2023-05-12 18:27:19 +02:00
Erik Auerswald bf4bc839f8 INSTALL: mention that pkg-config replaces imlib2-config
At least on still supported Debian and Ubuntu GNU/Linux systems,
both pkg-config and imlib2-config can be used to determine the
LDFLAGS needed to link against Imlib2.  Current upstream Imlib2
no longer provides imlib2-config, but only pkg-config data.
2022-01-24 20:50:29 +01:00
Erik Auerswald 643dbb85b0 INSTALL: remove "rman" from prerequisites
Since commit efded91c1d rman is
no longer used to convert the man page to HTML.
2022-01-24 20:48:47 +01:00
Erik Auerswald 8464c5c2b9 INSTALL: adjust to removed -Werror & -pedantic-errors 2021-10-25 20:11:19 +02:00
Erik Auerswald 5c8fb87549 INSTALL: mention X11 as prerequisite 2021-10-24 15:19:35 +02:00
Erik Auerswald 36d314889f add more macOS info to INSTALL
GitHub user "watkit" reported to have needed

    make CPPFLAGS=-I/Library/Developer/CommandLineTools/SDKs/MacOSX11.3.sdk/System/Library/Frameworks/Tk.framework/Versions/8.5/Headers/

to build ssocr on a 2020 m1 Mac mini.
2021-10-24 15:05:39 +02:00
Erik Auerswald 24b4d7ab7c INSTALL: use current Homebrew URL 2021-06-24 20:25:59 +02:00
Erik Auerswald 60735c3ff6 replace http URLs with https 2021-06-24 20:13:10 +02:00
Erik Auerswald 159f9c1809 INSTALL: fix typo 2021-04-11 18:44:59 +02:00
Erik Auerswald 08a628ff04 how to work around some compilation failures
C compilers are getting more aggressive with warnings and are producing
more false positives.  While I intend to keep ssocr compiling without
warnings (as in the last 15 years), I do not use the newest C compilers,
but rather the GCC version included in a stable GNU/Linux distribution,
it may take some time for me to encounter those problems myself, and thus
it may take some time for me to work around them.

A user reported a compilation failure due to new warnings in GCC 10.1.
Since I currently use GCC 7.5.0 from Ubuntu 18.04 LTS, I do not see
those warnings yet, and thus cannot test any workarounds yet.

A first investigation into the issue hints at a need to replace valid code
with code invalid for GCC's default C standard version (necessitating
the specification of a newer C standard in the CFLAGS) to work around
said problem.  I have no idea if there are additional warnings with GCC
10.1 after working around that one.  Since Google blocks my emails to
the reporting user, I cannot even communicate to find this out.  Thus any
code changes will have to wait for either a GCC version with additional
warnings arriving in my GNU/Linux distribution, or establishment of a
different communication channel, e.g., a GitHub issue.
2020-08-03 23:12:08 +02:00
Erik Auerswald 3a08177381 INSTALL: reword some platform specific advise 2020-08-02 23:51:47 +02:00
Erik Auerswald ddeeaffff7 INSTALL: inform about C compiler security features
There have been issues with the basic security features a modern C
compiler should provide, hindering compilation of ssocr. One way to work
around those is to disable use of the broken features.  Another way is
to use a quality C compiler, e.g., a stable GCC release.
2020-08-02 23:39:07 +02:00
Erik Auerswald 4540283ae3 INSTALL: indent verbatim commands 2019-05-30 13:29:47 +02:00
Erik Auerswald 46fe73b6fc INSTALL: .deb package is built with 'make selfdeb' 2019-05-30 13:28:11 +02:00
Erik Auerswald 0c2599510f Makefile maintenance
- rename target "nodeb" to "selfdeb"
- document new Makefile targets in INSTALL
2018-10-14 14:14:55 +02:00
Erik Auerswald 5e47e26b12 INSTALL: correct "origin" of common tools
All "common" tools used to build ssocr have been part of GNU/Linux
distribtuions for decades. But since more people want to build ssocr
on non-GNU systems it might be helpful to hint at where to find the
common utility programs:

- some are used in a POSIX compatible way
- some are part of GNU
- then there are others
2018-08-11 16:12:58 +02:00
Erik Auerswald 60a5b3c62c add more details to INSTALL, e.g. needed utilities 2018-08-05 05:35:14 +02:00
Erik Auerswald ad22b57761 INSTALL: mention macOS include path oddity 2018-03-02 11:56:51 +01:00
Erik Auerswald 6b5a3199de Windows might need .exe extension for binary, mention in INSTALL 2015-03-11 10:00:39 +00:00
Erik Auerswald 04afa48720 Added imlib2-config as explicit requirement to INSTALL. 2014-04-03 11:20:30 +00:00
Erik Auerswald 558c06f654 INSTALL: added link to ssocr website 2013-01-11 11:20:22 +00:00
Erik Auerswald 5a4e0ef5e0 Added some more Mac OS X compatibility stuff:
- use optimization level -O3, which is supported by both gcc and clang
- removed a set of unnecessary parenthesis
- added info about 'brew' on Mac OS X to INSTALL file

bumped version number to 2.13.3
2013-01-11 10:26:57 +00:00
Erik Auerswald 4caf2faf18 Added INSTALL file, installed to documentation directory. 2012-07-10 17:43:50 +00:00