retawq Documentation
Compile-Time Configuration Options

Introduction

For configuring retawq before building the program ("compile-time configuration"), both the "classical" Makefiles and the more modern configure scripts are supported.

The Options

Minimizing retawq's Size

retawq is already a quite small browser. If you want to make the executable program still smaller, e.g. as a tool for a boot/rescue disk or a "whole system on one floppy disk" collection, this section shows how to shrink retawq's size by disabling "all" compile-time options, including some internal options which aren't documented elsewhere. If you actually need a feature, you should leave the respective option enabled, of course. The minimization is shown with the configure script here; you can get the same result by editing the "classical" Makefile manually.

As a starting point, disable all officially documented options which are enabled by default: "./configure --disable-ncurses --disable-textmodemouse --disable-cookies --set-ced=0".

Now for the "dirty" part: open the file ".config" (which was generated by the configure script) in a text editor, and do the following (in parentheses: effect of the change):

Finally, say "make" to build the program. Let's have a look at the result, for example when building version 0.1.4 on the x86 platform, Linux kernel 2.2.x, compiler GNU gcc 2.7.2.3 (leaving ncurses enabled because it's needed): minimal - 83 KB; default - 103 KB; everything enabled - 115 KB. Support for i18n costs about 7 KB, support for cookies about 9 KB here.


This documentation file is part of version 0.1.4 of retawq, a network client created by Arne Thomaßen. retawq is basically released under certain versions of the GNU General Public License and WITHOUT ANY WARRANTY. Copyright (C) 2001-2002 Arne Thomaßen.