-
Notifications
You must be signed in to change notification settings - Fork 4
/
Copy pathINSTALL
131 lines (93 loc) · 4.6 KB
/
INSTALL
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
INSTALL - OpenPrinting Braille Printer Application v2.0b1 - 2022-11-18
----------------------------------------------------------------------
This file describes how to compile and install OpenPrinting
braille-printer-app from source code. For more information on
OpenPrinting braille-printer-app see the file called "README.md". A
complete change log can be found in "CHANGES.md".
BEFORE YOU BEGIN
You'll need ANSI-compliant C compiler, a make program, POSIX-compliant
shell (/bin/sh) and programs needed for "autogen.sh" script - autoconf,
automake, autopoint and libtool. The GNU compiler tools and Bash work well
and we have tested the current CUPS code against several versions of GCC
with excellent results.
The Makefiles used by the project should work with most versions of make.
We've tested them with GNU make as well as the make programs shipped by
Compaq, HP, SGI, and Sun. BSD users should use GNU make (gmake) since BSD
make does not support "include".
The following development files must be installed to be able to compile
this package:
- [PAPPL](https://www.msweet.org/pappl) 1.1 or later.
- [CUPS](https://openprinting.github.io/cups) 2.2.2 or later (for libcups).
- [CUPS-FILTER](https://github.com/OpenPrinting/cups-filters) 2.0 or later.
- [LIBMAGIC](https://www.darwinsys.com/file/)
COMPILING THE GIT REPOSITORY CODE
The braille-printer-app GIT repository doesn't hold a copy of the pre-built
configure script. You'll need to run the GNU autoconf software (2.65 or
higher) to create it:
./autogen.sh
CONFIGURATION
braille-printer-app uses GNU autoconf, so you should find the
usual "configure" script in the main braille-printer-app source
directory. To configure braille-printer-app for your system,
type:
./configure
The default installation will put the braille-printer-app software in the
"/usr" directory on your system.
Use the "--prefix" option to install the braille-printer-app
software in another location:
./configure --prefix=/some/directory
To see a complete list of configuration options, use the --help option:
./configure --help
If any of the dependent libraries are not installed in a system default
location (typically "/usr/include" and "/usr/lib") you'll need to set the
CFLAGS, CPPFLAGS, CXXFLAGS, DSOFLAGS, and LDFLAGS environment variables
prior to running configure:
setenv CFLAGS "-I/some/directory"
setenv CPPFLAGS "-I/some/directory"
setenv CXXFLAGS "-I/some/directory"
setenv DSOFLAGS "-L/some/directory"
setenv LDFLAGS "-L/some/directory"
./configure ...
or:
CFLAGS="-I/some/directory" \
CPPFLAGS="-I/some/directory" \
CXXFLAGS="-I/some/directory" \
DSOFLAGS="-L/some/directory" \
LDFLAGS="-L/some/directory" \
./configure ...
Once you have configured things, just type:
make ENTER
or if you have FreeBSD, NetBSD, or OpenBSD type:
gmake ENTER
to build the software.
INSTALLING THE SOFTWARE
Once you have built the software you need to install it. The "install"
target provides a quick way to install the software on your local system:
make install ENTER
or for FreeBSD, NetBSD, or OpenBSD:
gmake install ENTER
PACKAGING THE SOFTWARE FOR OPERATING SYSTEM DISTRIBUTIONS
This Braille embosser support package is important for
accessibility, for written, paper-based communication with blind
people. So it is highly recommended for desktop distributions and
generally distributions with a CUPS printing stack.
In addition to the package itself several other packages can be
required based on packager's decision which file formats the Braille
printer application should support. The binaries, the formats they support
and possible package name are:
- lou_translate - for musicxml files and backup Braille translations,
from liblouis package,
- convert - for raster images, from ImageMagick,
- pdftotext - for PDFs, from poppler-utils,
- file2brl - for text files and best Braille translations,
from liblouisutdml,
- inkscape - for vector images, from inkscape,
- lynx - for html files, from lynx,
- antiword - for MS Word doc files, from antiword,
- cups-filters 2.x - for possible input file's conversion into
formats which Braille filters accept,
- docx2txt - for MS Word docx files,
- unzip - for OpenOffice/Libreoffice file conversions, from unzip,
- rtf2txt - for translating RTF files, from rtf2txt,
- FreeDots - for better translation of musicxml files, from FreeDots
None of these is needed for compiling braille-printer-app.