Write a new README that should make building and setting up the browser easier

This commit is contained in:
Juhani Krekelä 2021-04-19 17:45:02 +03:00
parent ac4dec4fe1
commit e9ba313131
2 changed files with 103 additions and 0 deletions

103
README.md Normal file
View File

@ -0,0 +1,103 @@
Chimera2
========
Chimera2 is a very lightweight web browser for X11/Athena. This source is
derived from the final development snapshot of Chimera 2.0p19, as well as
well as the Debian patches that continued until 2013, both of which can be
gotten from [Debian jessie's package](https://packages.debian.org/source/jessie/chimera2)
Building
--------
Debian lists the following packages as required for building:
- libjpeg-dev
- libpng-dev
- xutils-dev
- zlib1g-dev
- libxaw7-dev
- libxmu-dev
- libxt-dev
- libsm-dev
- libice-dev
- libxpm-dev
- libxext-dev
- libx11-dev
The build system is rather archaic, and is tuned by modifying `Common.tmpl`
and `Imakefile`. Once you're fine with your modifications (or just want to
use the shipped defaults), run
xmkmf -a &&
make
This should give you a binary at `chimera/chimera`, which appears to be
fully self-contained.
Run-time configuration
----------------------
Chimera2 uses an x11-style resources file at ~/.chimera/resources, and will
not start up unless you define at least `html.defaultFont` in there. The
following is a full list of resources that Chimera2 appears to use and
examples of values or ??? in case the usage is unclear and it is not set
anywhere in the code.
convert.convertFiles: ~/.chimera_convert:~john/lib/convert:/local/infosys/lib/convert
html.defaultFont: -*-*-*-*-*-*-*-*-*-*-*-*-*-*
html.propFontPattern: -*-lucida-*-*-*-*-*-*-*-*-*-*-iso10646-1
html.fixedFontPattern: -*-fixed-*-*-*-*-*-*-*-*-*-*-iso8859-1
html.leftMargin: 20
html.rightMargin: 20
html.bottomMargin: 20
html.topMargin: 20
html.printHTMLErrors: false
html.textLineSpace: 3
html.tableCellInfinity: 0
html.inlineTimeOut: 5000
html.selectTimeOut: 1000
html.flowDebug: false
html.constraintDebug: false
html.printTags: false
html.cssFile: ~/.chimera/default.css
html.dlIndent: 20
plain.font: -*-lucida-medium-r-normal-sans-17-120-100-100-p-96-iso10646-1
chimera.helpURL: ???
chimera.homeURL: http://example.org
chimera.maxDownloads: 4
chimera.printLoadMessages: false
chimera.printTaskInfo: false
chimera.urlLogFile: ~/debug/chimeraurls.log
cache.directory: ~/.chimera/cache
cache.persist: false
cache.ignoreExpires: false
cache.maxSize: 0
cache.ttl: 0
view.path: /usr/local/bin:/usr/bin:/bin
view.capFiles: ~/.chimera/mailcap:~/.mailcap
bookmark.filename: ~/.chimera/bookmarks.html
bookmark.header: <html><body><h2>Bookmarks</h2><ul>
bookmark.footer: </ul></body></html>
file.autoLoad: index.html
http.userAgent: Chimera/2.0alpha
http.acceptLanguage: fi;q=1,en;q=0.9
ftp.dirheader: <html><body><h2>FTP Directory</h2><ul>
ftp.dirtrailer: </ul></body></html>
mailto.dirheader: <html><body><h2>Mailto</h2><ul>
mailto.dirtrailer: </body></html>
user.email: foobar@example.org
mailto.mailer: /usr/bin/sendmail -t
You'll most likely want to use a simpler configuration than this. A usable
default `.chimera/resources` is
html.defaultFont: -*-*-*-*-*-*-*-*-*-*-*-*-*-*
chimera.homeURL: http://example.org
bookmark.filename: ~/.chimera/bookmarks.html

View File