vimb.git
11 years agoFixed wrong history prefixes.
Daniel Carl [Tue, 26 Mar 2013 23:17:54 +0000 (00:17 +0100)]
Fixed wrong history prefixes.

If the ':' was typed into input box and the history search started and a
history item with :open ... was put into input box, the next history step used
the ':open ' as a new prefix for commands to fill. Now the input is only
processed at the start of the history searching, so that later changes won't
corrupt the printed items.
Also fixed missed first item in stepping forward through the history.
Al least the global variables out of the vb struct where removed to start to
decentralize the data stores and to them from the rest of the application.

11 years agoFixed wrong command history sorting.
Daniel Carl [Mon, 25 Mar 2013 20:48:50 +0000 (21:48 +0100)]
Fixed wrong command history sorting.

11 years agoRenamed command-hist-* command to hist-*.
Daniel Carl [Mon, 25 Mar 2013 20:48:27 +0000 (21:48 +0100)]
Renamed command-hist-* command to hist-*.

11 years agoAllow to set a default search engine.
Daniel Carl [Mon, 25 Mar 2013 20:35:38 +0000 (21:35 +0100)]
Allow to set a default search engine.

Added command searchengine-default to set the handle of the default search
engine.

11 years agoBlur the active element if insert mode is left.
Daniel Carl [Mon, 25 Mar 2013 19:39:14 +0000 (20:39 +0100)]
Blur the active element if insert mode is left.

If a editable form element was focussed, vimb browser switched to insert mode.
But if the insert mode was left by hitting <esc> the element kept focused, so
that key-presses went still into the focused element.

11 years agoFixed potentially uninitialized variable.
Daniel Carl [Sun, 24 Mar 2013 19:11:37 +0000 (20:11 +0100)]
Fixed potentially uninitialized variable.

11 years agoRemoved overkilled g_strsplit from command handling.
Daniel Carl [Sun, 24 Mar 2013 18:59:29 +0000 (19:59 +0100)]
Removed overkilled g_strsplit from command handling.

11 years agoMoved search handle finding from command_open to vb_load_uri.
Daniel Carl [Sun, 24 Mar 2013 18:49:17 +0000 (19:49 +0100)]
Moved search handle finding from command_open to vb_load_uri.

11 years agoShow first part of inputbox if history items it too long.
Daniel Carl [Sun, 24 Mar 2013 17:57:10 +0000 (18:57 +0100)]
Show first part of inputbox if history items it too long.

If a too long history items was displayed we put also the cursor to the end of
the value. But this causes that the first, and potentially more interesting
part was hidden. Now we place the cursor to the beginning, if the printed
content in inputbox is too long.

11 years agoSplit command history into command and search history.
Daniel Carl [Sun, 24 Mar 2013 17:14:30 +0000 (18:14 +0100)]
Split command history into command and search history.

Allow special history also for :open and :tabopen commands.

11 years agoSimplified the SEARCH_* enum.
Daniel Carl [Sun, 24 Mar 2013 14:56:31 +0000 (15:56 +0100)]
Simplified the SEARCH_* enum.

now we use -1 for backward and 1 for forward which is easier to use in the
most cases.

11 years agoMerged url_history and history together.
Daniel Carl [Sun, 24 Mar 2013 14:38:00 +0000 (15:38 +0100)]
Merged url_history and history together.

The history mechanism can now handle different types of history and persist
the items into different files.

11 years agoFixed wrong url history loading.
Daniel Carl [Sun, 24 Mar 2013 12:15:36 +0000 (13:15 +0100)]
Fixed wrong url history loading.

If the history where larger than the maximum allowed size, we read max of the
items from the beginning of the file that are the oldest items, so that the
latest items where discarded.

11 years agoRenamed type VpColor -> VbColor.
Daniel Carl [Sat, 23 Mar 2013 23:11:05 +0000 (00:11 +0100)]
Renamed type VpColor -> VbColor.

11 years agoUsed macro GET_TEXT() where it where not used before.
Daniel Carl [Sat, 23 Mar 2013 23:08:37 +0000 (00:08 +0100)]
Used macro GET_TEXT() where it where not used before.

11 years agoFixed wrong mode if no hints where found.
Daniel Carl [Sat, 23 Mar 2013 22:24:24 +0000 (23:24 +0100)]
Fixed wrong mode if no hints where found.

If hinting was started, but no hint was found, the input box was still
activated. Now we set the hint mode immediately in the hints_create function.
In the previous implementation the hinting mode was set in the command
function that didn't know if a hint where found or not and switched to hinting
mode also if no hint mas found.

11 years agoAdded function to echo also if input is focused.
Daniel Carl [Sat, 23 Mar 2013 21:57:49 +0000 (22:57 +0100)]
Added function to echo also if input is focused.

Removed none used vb_clear_input function.

11 years agoUse g_object_connect also for the webinspector events.
Daniel Carl [Sat, 23 Mar 2013 21:40:49 +0000 (22:40 +0100)]
Use g_object_connect also for the webinspector events.

11 years agoChanged keybindings for stop loading.
Daniel Carl [Sat, 23 Mar 2013 21:36:27 +0000 (22:36 +0100)]
Changed keybindings for stop loading.

The previous keybindings ctrl-c did not work, because this was caught as
escape sequence.

11 years agoAdapted README and user markdown now.
Daniel Carl [Sat, 23 Mar 2013 15:47:41 +0000 (16:47 +0100)]
Adapted README and user markdown now.

11 years agoSimplified history saving.
Daniel Carl [Sat, 23 Mar 2013 15:13:40 +0000 (16:13 +0100)]
Simplified history saving.

The url history is written to the end of the history file. The history isn't
read into list if not required. Every time we need the history we read it new
from file, so we would always see item added by another browser instance. If
the browser is closed the history files loaded again, duplicates will be
removed and the list shortened to the max history length and written back to
the file.

11 years agoUse the MFLAGS for every make call to a subdirectory.
Daniel Carl [Sat, 23 Mar 2013 11:15:37 +0000 (12:15 +0100)]
Use the MFLAGS for every make call to a subdirectory.

11 years agoRenamed the option to dump config to stdout.
Daniel Carl [Sat, 23 Mar 2013 11:11:40 +0000 (12:11 +0100)]
Renamed the option to dump config to stdout.

Added the new config to the manual page.

11 years agoRemoved dependency to m4 processor to build manpage.
Daniel Carl [Sat, 23 Mar 2013 11:05:00 +0000 (12:05 +0100)]
Removed dependency to m4 processor to build manpage.

The overkill of the m4 isn't required to simply replace VERSION and PROJECT in
the manual page.

11 years agoFixed wrong config pathes in man page.
Daniel Carl [Sat, 23 Mar 2013 10:56:46 +0000 (11:56 +0100)]
Fixed wrong config pathes in man page.

11 years agoFixed url hostory init bug.
Daniel Carl [Sat, 23 Mar 2013 10:48:58 +0000 (11:48 +0100)]
Fixed url hostory init bug.

If the browser read the history from file in the init function the history max
items where not set so we considered the max items to be 0. Now the url
history is initialized if the config is processed.

11 years agoReduced the number of webkit settings.
Daniel Carl [Sat, 23 Mar 2013 10:27:39 +0000 (11:27 +0100)]
Reduced the number of webkit settings.

The less setting we must parse the faster we can apply the settings. Also the
setting completions will keep readable. If anyone like a special setting to be
configurable to runtime, it's an easy job to add the item to the setting list
and to the default config.

11 years agoRemove no more used global flag from settings.
Daniel Carl [Sat, 23 Mar 2013 10:18:58 +0000 (11:18 +0100)]
Remove no more used global flag from settings.

11 years agoPut the default settings in config.h.
Daniel Carl [Sat, 23 Mar 2013 10:00:28 +0000 (11:00 +0100)]
Put the default settings in config.h.

Now the default settings are also put in the config.h so that it's easy to
print all default settings and keybindings to stdout. Added new option to dump
all default settings and keybindings to stdout (-D).

Parsing from default config is only a little slower than the previous
approach, but it more equal to the other configuration stuff.

11 years agoDon't check for keypresses on the inspector pane.
Daniel Carl [Sat, 23 Mar 2013 00:09:30 +0000 (01:09 +0100)]
Don't check for keypresses on the inspector pane.

Instead of checking the key actions on the whole window we use the box
instead, that holds nearly everything but the inspector pane. Else pressing
'd' in the inspectors search box would close the browser window.

11 years agoRevert to single instance per window.
Daniel Carl [Fri, 22 Mar 2013 16:43:08 +0000 (17:43 +0100)]
Revert to single instance per window.

11 years agoAdded support for relative path for vimb.
Daniel Carl [Mon, 18 Mar 2013 00:30:18 +0000 (01:30 +0100)]
Added support for relative path for vimb.

11 years agoChanged function prefix from vp_ to vb_.
Daniel Carl [Sun, 17 Mar 2013 23:55:02 +0000 (00:55 +0100)]
Changed function prefix from vp_ to vb_.

11 years agoRenamed the project from vimp to vimb.
Daniel Carl [Sun, 17 Mar 2013 23:47:08 +0000 (00:47 +0100)]
Renamed the project from vimp to vimb.

There is already a software calles vimp so I think it will be better to rename
this little project.

11 years agoMerge branch 'single-client'
Daniel Carl [Wed, 13 Mar 2013 23:54:28 +0000 (00:54 +0100)]
Merge branch 'single-client'

Conflicts:
src/url_history.c

11 years agoUpdated man page for the changed file locations.
Daniel Carl [Wed, 13 Mar 2013 23:52:49 +0000 (00:52 +0100)]
Updated man page for the changed file locations.

11 years agoRemove unneeded assignment of hint object.
Daniel Carl [Wed, 13 Mar 2013 23:34:56 +0000 (00:34 +0100)]
Remove unneeded assignment of hint object.

11 years agoRenamed config files to local.conf and global.conf.
Daniel Carl [Wed, 13 Mar 2013 23:22:56 +0000 (00:22 +0100)]
Renamed config files to local.conf and global.conf.

Don't create the user style.css file if not exists.

11 years agoShortened hints.js and move some variable declarations.
Daniel Carl [Wed, 13 Mar 2013 22:28:38 +0000 (23:28 +0100)]
Shortened hints.js and move some variable declarations.

11 years agoFixed none cleared hints within frames.
Daniel Carl [Wed, 13 Mar 2013 21:39:53 +0000 (22:39 +0100)]
Fixed none cleared hints within frames.

11 years agoDon't remove target attributes with none _blank value.
Daniel Carl [Wed, 13 Mar 2013 21:35:22 +0000 (22:35 +0100)]
Don't remove target attributes with none _blank value.

If a framesite uses the target attribute to open a link into a defined frame
we removed this useful attribute too during hinting the link. Now only target
via value _blank are removed just before clicking the hint.

11 years agoFixed input box cleaning after hinting to input element.
Daniel Carl [Tue, 12 Mar 2013 23:01:47 +0000 (00:01 +0100)]
Fixed input box cleaning after hinting to input element.

If a form input element was focused via hinting, the message to the user
-- INPUT -- was removed from input box. Now we don't clear the input box if
the element is focused by hinting to keep the user informed about the current
mode.

11 years agoShortened some variable names in hinting script.
Daniel Carl [Tue, 12 Mar 2013 22:56:34 +0000 (23:56 +0100)]
Shortened some variable names in hinting script.

11 years agoFire also all possible mouse events on form fields.
Daniel Carl [Tue, 12 Mar 2013 22:42:59 +0000 (23:42 +0100)]
Fire also all possible mouse events on form fields.

11 years agoTrigger mouse events when hint is fired.
Daniel Carl [Tue, 12 Mar 2013 21:58:22 +0000 (22:58 +0100)]
Trigger mouse events when hint is fired.

Trigger the mousedown, mouseup and click event like a real mouse click.
Removed the _openNewWindow function in favor to reuse the _open function to do
the same.

11 years agoUse document fragment for the hint nodes.
Daniel Carl [Mon, 11 Mar 2013 21:20:02 +0000 (22:20 +0100)]
Use document fragment for the hint nodes.

The appendChild in the fragment is faster than multiple operation on document.

11 years agoRemoved additional error string for vp_eval_script.
Daniel Carl [Mon, 11 Mar 2013 19:14:06 +0000 (20:14 +0100)]
Removed additional error string for vp_eval_script.

Return the boolean status to indicate if an error occurred and put the error
also into given value pointer. This makes the api easier to call and we don't
need to concern about which given string have to be freed.

11 years agoChanged url_history_get_all to add the entries to existing given list.
Daniel Carl [Sat, 9 Mar 2013 00:36:25 +0000 (01:36 +0100)]
Changed url_history_get_all to add the entries to existing given list.

This will allow us to combine url history and later to implement bookmarks in
a single completion list.

11 years agoChanged error message if inspect command is called.
Daniel Carl [Sat, 9 Mar 2013 00:20:48 +0000 (01:20 +0100)]
Changed error message if inspect command is called.

If the webinspector isn't enabled the error messaged showed the webkit setting
that is not set to use the webinspector. But this setting has an alias and can
therefore only be set by the alias. So we print the alias in the error
message.

11 years agoMoved hint mode and usage params to the hint instantiation.
Daniel Carl [Sat, 9 Mar 2013 00:15:25 +0000 (01:15 +0100)]
Moved hint mode and usage params to the hint instantiation.

It's better to set those settings to the constructor of the hinting object
instead of giving this to the hints create function. Also the config object
was emoved to keep the JavaScript a little smaller.

11 years agoOpen hinted link via click event from JavaScript.
Daniel Carl [Fri, 8 Mar 2013 23:37:10 +0000 (00:37 +0100)]
Open hinted link via click event from JavaScript.

If the link has no url source, we can't open it using the logic in the hint.c
file. So we create the mouse event to open also links that have only
JavaScript event listeners attached.

11 years agoFixed some memory leaks in completion and dom handling.
Daniel Carl [Tue, 5 Mar 2013 13:00:18 +0000 (14:00 +0100)]
Fixed some memory leaks in completion and dom handling.

11 years agoFixed a url history memory leak.
Daniel Carl [Tue, 5 Mar 2013 15:52:16 +0000 (16:52 +0100)]
Fixed a url history memory leak.

11 years agoUse some logic together for all windows.
Daniel Carl [Mon, 4 Mar 2013 21:45:20 +0000 (22:45 +0100)]
Use some logic together for all windows.

11 years agoRemordered functions in main.c.
Daniel Carl [Mon, 4 Mar 2013 18:46:14 +0000 (19:46 +0100)]
Remordered functions in main.c.

11 years agoSet the defualt settings of webkit to the webkit defaults.
Daniel Carl [Mon, 4 Mar 2013 18:23:24 +0000 (19:23 +0100)]
Set the defualt settings of webkit to the webkit defaults.

Removed unneeded settings like the private browsing and those that are marked
as deprecated.

11 years agoFixed missed counter in completion processing.
Daniel Carl [Mon, 4 Mar 2013 17:49:36 +0000 (18:49 +0100)]
Fixed missed counter in completion processing.

Remove unneeded gtk_widget_show calls.

11 years agoSimplified the completion widgets style settings.
Daniel Carl [Mon, 4 Mar 2013 16:21:56 +0000 (17:21 +0100)]
Simplified the completion widgets style settings.

Don't overwrite the colors of the completion labels. Instead we set the style
for the normal and active state and switch this during cycling through the
list.

11 years agoDon't save completion prefixes for each item.
Daniel Carl [Mon, 4 Mar 2013 15:02:41 +0000 (16:02 +0100)]
Don't save completion prefixes for each item.

11 years agoAllow to update completions by explicit typed input.
Daniel Carl [Mon, 4 Mar 2013 14:50:27 +0000 (15:50 +0100)]
Allow to update completions by explicit typed input.

Now we can complete ':se' to ':set' and type an additional space and press tab
again to start a new completion for settings.

11 years agoSort url completions by their usage.
Daniel Carl [Mon, 4 Mar 2013 13:16:30 +0000 (14:16 +0100)]
Sort url completions by their usage.

11 years agoFixed some more memory leaks.
Daniel Carl [Mon, 4 Mar 2013 13:14:08 +0000 (14:14 +0100)]
Fixed some more memory leaks.

11 years agoAdded url completion for :open and :tabopen commands.
Daniel Carl [Sun, 3 Mar 2013 16:22:09 +0000 (17:22 +0100)]
Added url completion for :open and :tabopen commands.

11 years agoMoved url history to own module.
Daniel Carl [Sun, 3 Mar 2013 15:21:25 +0000 (16:21 +0100)]
Moved url history to own module.

The history is loaded into a list if the browser is started. After that the
history items are only prepended to the internal list. Only if the apllication
is closed, we write the internal url history list to the history file.

11 years agoSave current visited url to history file.
Daniel Carl [Sun, 3 Mar 2013 13:33:57 +0000 (14:33 +0100)]
Save current visited url to history file.

11 years agoAdded new files for history and user stylesheets.
Daniel Carl [Sun, 3 Mar 2013 12:36:22 +0000 (13:36 +0100)]
Added new files for history and user stylesheets.

11 years agoFixed segmentation fault on freeing temporary history.
Daniel Carl [Sun, 3 Mar 2013 11:09:56 +0000 (12:09 +0100)]
Fixed segmentation fault on freeing temporary history.

If the temporary active history where freed, the pointer in the global history
where also freed and crashed the browser if we try to free them again.

11 years agoRemoved hint processings out of the javascript.
Daniel Carl [Sun, 3 Mar 2013 10:08:55 +0000 (11:08 +0100)]
Removed hint processings out of the javascript.

Cause of the processings that where know in the c-layer and the javascript
layer too, we got really complicated code. Now the javascript-layer did no
know anything of how the hinted sources should be used by the browser. This
only concern that is kept in the javascript are the different types of
elements that are hintable.

11 years agoShow hinted element source in status bar.
Daniel Carl [Sun, 3 Mar 2013 08:52:30 +0000 (09:52 +0100)]
Show hinted element source in status bar.

11 years agoGive the web frame to the functions that call javascript.
Daniel Carl [Sun, 3 Mar 2013 08:32:13 +0000 (09:32 +0100)]
Give the web frame to the functions that call javascript.

11 years agoStop hinting if no element is found.
Daniel Carl [Fri, 1 Mar 2013 16:18:22 +0000 (17:18 +0100)]
Stop hinting if no element is found.

11 years agoReleased version 0.1.4.
Daniel Carl [Fri, 1 Mar 2013 16:04:38 +0000 (17:04 +0100)]
Released version 0.1.4.

11 years agoAdded hinting mode to open images.
Daniel Carl [Fri, 1 Mar 2013 15:50:22 +0000 (16:50 +0100)]
Added hinting mode to open images.

With the ;i or ;I hinting mode images can be hinted end opened.

11 years agoDon't show the hint commands as script files in inspector.
Daniel Carl [Fri, 1 Mar 2013 14:44:08 +0000 (15:44 +0100)]
Don't show the hint commands as script files in inspector.

11 years agoAllow to set script name if a javascript is evaluated.
Daniel Carl [Fri, 1 Mar 2013 14:28:50 +0000 (15:28 +0100)]
Allow to set script name if a javascript is evaluated.

11 years agoRenamed hinting js file from hint.js -> hints.js.
Daniel Carl [Fri, 1 Mar 2013 14:13:42 +0000 (15:13 +0100)]
Renamed hinting js file from hint.js -> hints.js.

11 years agoFixed some coding issues in hint.js.
Daniel Carl [Fri, 1 Mar 2013 14:10:26 +0000 (15:10 +0100)]
Fixed some coding issues in hint.js.

11 years agoRemove no more used type short cuts from dom module.
Daniel Carl [Wed, 27 Feb 2013 23:46:49 +0000 (00:46 +0100)]
Remove no more used type short cuts from dom module.

11 years agoReplaced hinting by javascript hinting.
Daniel Carl [Wed, 27 Feb 2013 22:53:13 +0000 (23:53 +0100)]
Replaced hinting by javascript hinting.

The previous approach to use the dom api to generate the hints was much slower
than the javascript solution. I think the javascript way is also a little bit
more flexible and easier to implement. But now we have to concern about data
sharing between c-layer an the javascript.

11 years agoAllow to run user scripts on every page.
Daniel Carl [Tue, 26 Feb 2013 22:50:11 +0000 (23:50 +0100)]
Allow to run user scripts on every page.

11 years agoBetter history lookup performance.
Daniel Carl [Tue, 26 Feb 2013 22:04:06 +0000 (23:04 +0100)]
Better history lookup performance.

Don't generate the list of matching item if we step through the items.
Generate the active list only one time and use it to step through the matching
history items.

11 years agoAdded search history (#8).
Daniel Carl [Sun, 24 Feb 2013 19:46:05 +0000 (20:46 +0100)]
Added search history (#8).

11 years agoSave the commands together with the prefix ':' in history (#7).
Daniel Carl [Sun, 24 Feb 2013 19:33:05 +0000 (20:33 +0100)]
Save the commands together with the prefix ':' in history (#7).

This is not so flexible, but makes many tings easier to implement to violate
the concerns of the components.

11 years agoImplemented prefix aware history searching (#7).
Daniel Carl [Sun, 24 Feb 2013 19:24:05 +0000 (20:24 +0100)]
Implemented prefix aware history searching (#7).

If ':set' is already typed in the inputbox, the history will only step over
those items that matches this prefix. Now vimp behave a little bit more like
the great vim editor.

11 years agoSplit the VpCore struct into the local and global part.
Daniel Carl [Sun, 24 Feb 2013 17:38:56 +0000 (18:38 +0100)]
Split the VpCore struct into the local and global part.

This makes the way to have global configs that are loaded on application start
an local settings that are kept for every window/tab.

11 years agoFixed wrong history entries is set command is called (#7).
Daniel Carl [Sun, 24 Feb 2013 17:58:46 +0000 (18:58 +0100)]
Fixed wrong history entries is set command is called (#7).

If a set command to read config is called like ':set fontsize?' which prints
the value into the inputbox, the printed result was put into history instead
of the real called command string.

11 years agoRemove unneeded status style setting.
Daniel Carl [Sun, 24 Feb 2013 13:50:51 +0000 (14:50 +0100)]
Remove unneeded status style setting.

11 years agoRemoved redundant and no more needed code.
Daniel Carl [Sat, 23 Feb 2013 23:38:05 +0000 (00:38 +0100)]
Removed redundant and no more needed code.

11 years agoMoved mode switching to command also if command not found.
Daniel Carl [Sat, 23 Feb 2013 10:41:27 +0000 (11:41 +0100)]
Moved mode switching to command also if command not found.

This make the mode switching more unique. If command_run is called, this will
switch to the right mode, independent if the command exists or could be run or
not.

11 years agoDon't save commands from config file and default config in history.
Daniel Carl [Sat, 23 Feb 2013 10:36:34 +0000 (11:36 +0100)]
Don't save commands from config file and default config in history.

11 years agoFixed missed freeing of list items.
Daniel Carl [Sat, 23 Feb 2013 10:31:53 +0000 (11:31 +0100)]
Fixed missed freeing of list items.

11 years agoRemoved {tab}open-home command.
Daniel Carl [Fri, 22 Feb 2013 21:55:16 +0000 (22:55 +0100)]
Removed {tab}open-home command.

The featured is done in the open command. If open is called without any url
the configured home page is opened.

11 years agoAdded parameters to commands in manpage.
Daniel Carl [Fri, 22 Feb 2013 21:44:46 +0000 (22:44 +0100)]
Added parameters to commands in manpage.

11 years agoRemove hard to read curly brace syntax for commands.
Daniel Carl [Fri, 22 Feb 2013 21:29:58 +0000 (22:29 +0100)]
Remove hard to read curly brace syntax for commands.

11 years agoAdded command to navigate in command history (#7).
Daniel Carl [Fri, 22 Feb 2013 21:23:06 +0000 (22:23 +0100)]
Added command to navigate in command history (#7).

11 years agoFixed code indentations.
Daniel Carl [Fri, 22 Feb 2013 20:09:51 +0000 (21:09 +0100)]
Fixed code indentations.

11 years agoFixed wrong mode if new window was opened.
Daniel Carl [Thu, 21 Feb 2013 21:03:59 +0000 (22:03 +0100)]
Fixed wrong mode if new window was opened.

If there was opened a uri into a new window the first window kept in command
mode. This caused that the normal mode keybindings did not work until <esc>
was pressed.

11 years agoCheck if uri is a file path before open it.
Daniel Carl [Thu, 21 Feb 2013 19:34:37 +0000 (20:34 +0100)]
Check if uri is a file path before open it.

11 years agoFixed bug in retrieving webkit settings of type char.
Daniel Carl [Tue, 19 Feb 2013 20:48:42 +0000 (21:48 +0100)]
Fixed bug in retrieving webkit settings of type char.

11 years agoUsed font switches in man page to make it more readable.
Daniel Carl [Sun, 17 Feb 2013 17:05:34 +0000 (18:05 +0100)]
Used font switches in man page to make it more readable.