[BRLTTY] README.Mac

[rmgls]

Hi Dave,

Please review this file and feel free to correct it or ask if
you need.
in all case:
please see the cfg-darwin file
i attached, it is running fine,
the only modified line is the prefix
near the end of the file.

when i i will have time i plan to make a brltty package in macports.
it will be of course easier to install it.
no need to compile nor xcode etc.

Best regards

Raoul MEGELAS
rmgls at orange.fr


          README.MAC
""""""""""""cut"""""""""""""""""""
This file is a first attempt to help installing brltty
on mac.

feel free to correct me if you find something wrong.

i suppose you know how to run VoiceOver (cmd+f5) and for help
ctrl+opt+h and for keyboard help:
ctrl+opt+k.

first you must download xcode from the app store.
once installed run it.
accept the license.
download the command line tools from the xcode menu

note: it is easier in the terminal to type:
xcode-select --install

this open a xcode window with another license acceptation!!!
with a little bit of patience you will have all 
xcode tools needed installed.

2. install macports.
macports are the packages you run on the terminal.
in safari go to http://www.macports.org => download
choose the package for your kernel:
(lion, ... siarra and so on), click to download, and noce downloaded
close safari and go to your downloads directory:
(command-shift-g) /users/YOURPATH/downloads.
open the .dmg file you just downloaded and install the soft
by following the instructions on screen.

3. in the terminal type:
port install git

go to your home path.

type:
git clone git://github.com/brltty/brltty

4. copy the screen compiled i attached to this file somewhere or in your bin
directory if you have created one
or in /opt/local/bin (attention, you must have enabled the root rights
on your machine:
(see in the menu bar apple => preferences => users and groups for this).

Other note:
OS X by default install their unpatched screen in /usr/bin/.
you cannont rename or delete it without any experience.
if you type screen, it is this one which is run!
you have to run screen with the entire path.
you can start brltty and screen from a batch file.

5. install the needed ports: autoconf etc:
the command is:

port install SOMEPORT 

if port cry (file not found or something else)
type: port search THEPORTNAME you want to install and see the
exact version you need to install.

6. go to brltty path. and as usual:
autogen.
cfg-darwin.

NOTTE: the path must be /usr/local/
because usr/bin is unwritable and protected.

if all goes well:
   make
and
(as root)r
    make install.

if brltty is installed,
close VO (VoiceOver) and type:
screen
brltty
with the appropriate command line.

that's all.

Note: at this time, some HID devices do not work on usb
but they work on bluetooth.
i will see this problem later.

in all case, the powerbraille is not affected by this problem.

another thing: you can even
(with the appropriate driver and usb to serial
interface)
run an old (serial braille device)!
my old serial vario is quite running on os x.
""""""""""""""""""cut""""""""""""""
-------------- next part --------------
A non-text attachment was scrubbed...
Name: screen
Type: application/octet-stream
Size: 491460 bytes
Desc: not available
URL: <http://brltty.com/pipermail/brltty/attachments/20170901/f9e4ce89/attachment-0002.obj>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: cfg-darwin
Type: application/octet-stream
Size: 1623 bytes
Desc: not available
URL: <http://brltty.com/pipermail/brltty/attachments/20170901/f9e4ce89/attachment-0003.obj>
-------------- next part --------------
??