X-Git-Url: https://git.armaanb.net/?a=blobdiff_plain;f=README;h=7b0509ad5dc0789cd65f8dcffb1087408426162e;hb=e925efe0ee1ad2276b66392da752341d2f451117;hp=d6bff5d5a655dff588322f4362a42363d3deca0d;hpb=15e4cb8ad0bcc9bc11a4470d1ae3bf93d16c05ae;p=chorizo.git

diff --git a/README b/README
index d6bff5d..7b0509a 100644
--- a/README
+++ b/README
@@ -1,60 +1,76 @@
-zea - zeig's einfach an
-=======================
+        _                _
+    ___| |__   ___  _ __(_)_______
+   / __| '_ \ / _ \| '__| |_  / _ \
+  | (__| | | | (_) | |  | |/ / (_) |
+   \___|_| |_|\___/|_|  |_/___\___/
+  https://sr.ht/~armaan/chorizo
 
-zea is a minimalistic web browser using Gtk2, GLib and WebKit. "Zeig's
-einfach an" is german and translates roughly to "just show it" (the damn
-web page).
+- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 
-Features:
-
-	- A WebKit viewport
-	- An input box to change the current URL
-	- Global content zoom
-	- Pluggability into suckless' tabbed
-	- vi-like scrolling (modified by CTRL)
-	- Searching the current page for a word
-	- Adblock
-	- Support for Flash and Java
+A simple web browser using GTK+ 3, GLib and WebKit2GTK+.
 
-Planned features:
+Features:
+    - A WebKit2 viewport
+    - An input box to change the URI, search the current page, or
+      search the web
+    - Tab management
+    - Full keyboard control
+    - An ini configuration file
+    - Built-in download manager
+    - Web feeds indicator
+    - Global content zoom
+    - Cooperative instances using FIFOs
+    - Certificate trust store
+    - User script support
+    - Extensions
 
-	- Keyword based searching (opening "wi foo" will search wikipedia)
+Refer to the manpages chorizo(1), chorizo-usage(1), and
+chorizo-config(5), for more information.
 
+Installation
+------------
 
-Using zea with tabbed
-====================
+The following C libraries are required:
 
-The order of arguments for zea doesn't matter. This means you can run it
-like this:
+    - GTK+ 3
+    - WebKit2 API for GTK+ 3
 
-	$ tabbed -c ./zea file:///home/hans/bookmarks.html -z 0.8 -e
+To generate the manpages, scdoc is required. This isn't necesary on
+release tarballs.
 
-Each new tab will then show your bookmarks and is scaled by a factor of
-0.8.
+chorizo expects to be run on a POSIX-ish operating system.
 
+To build and install the program:
 
-Adblock
-=======
+    $ make
+    # make install
 
-zea has built-in adblock functionality. In each line of
 
-	~/.config/zea/adblock.black
+Background information
+----------------------
 
-you can store a regular expression. These expressions match
-case-insensitive and partially, i.e. ".*foo.*" is the same as ".*FOO.*"
-and you can use anchors like "^https?://...".
+What chorizo is and what it's not
 
+  chorizo does what I need. It won't do other things. I'm open for
+  contributions but please don't be upset if I turn them down -- which
+  might happen if it's a feature that I simply don't need.
 
-Literature
-==========
+  chorizo does not compete with powerful browsers like dwb or luakit, nor
+  with monstrous applications like Firefox or Chromium. Because under
+  the hood chorizo is powered by WebKit, however, it is on par with
+  browsers like Safari for page rendering features.
 
-API references:
+How is chorizo related to lariza?
 
-	- http://webkitgtk.org/reference/webkitgtk/stable/index.html
-	- https://developer.gnome.org/gtk2/stable/index.html
-	- https://developer.gnome.org/glib/stable/index.html
+  chorizo is a fork of the lariza browser by Peter Hofmann. I wanted
+  to take it in a slightly different direction (mostly just adding
+  features not considered to be in the spirit of lariza), so I forked
+  it. The name was changed in order to reduce confusion between the
+  two browsers as they grew apart. The versioning scheme was also
+  changed from being calendar-based to following the semantic
+  versioning scheme.
 
-Regular expressions supported by GRegex, you can use these in your
-adblock patterns:
 
-	- https://developer.gnome.org/glib/stable/glib-regex-syntax.html
+Copyright
+---------
+MIT License, see the LICENSE file for more information.
\ No newline at end of file