Convert README.md to markdown syntax.

This commit is contained in:
Romain Failliot 2015-11-21 13:21:21 -05:00
parent 08d0b616d8
commit f34cf304f8
1 changed files with 32 additions and 39 deletions

View File

@ -1,4 +1,5 @@
# Diffuse # Diffuse
Version 0.4.8 Version 0.4.8
Copyright (C) 2006-2014 Derrick Moser <derrick_moser@yahoo.com> Copyright (C) 2006-2014 Derrick Moser <derrick_moser@yahoo.com>
@ -13,23 +14,21 @@ also retrieve revisions of files from Bazaar, CVS, Darcs, Git, Mercurial,
Monotone, RCS, Subversion, and SVK repositories for comparison and merging. Monotone, RCS, Subversion, and SVK repositories for comparison and merging.
Some key features of Diffuse: Some key features of Diffuse:
- ability to compare and merge an arbitrary number of files side-by-side (n-way merges)
- line matching can be manually corrected by the user
- ability to directly edit files
- syntax highlighting
- Bazaar, CVS, Darcs, Git, Mercurial, Monotone, RCS, Subversion, and SVK support
- Unicode support
- unlimited undo
- easy keyboard navigation
---- * Ability to compare and merge an arbitrary number of files side-by-side (n-way
merges)
* Line matching can be manually corrected by the user
* Ability to directly edit files
* Syntax highlighting
* Bazaar, CVS, Darcs, Git, Mercurial, Monotone, RCS, Subversion, and SVK support
* Unicode support
* Unlimited undo
* Easy keyboard navigation
Requirements: ## Requirements
- Python >= 2.4 * Python >= 2.4
- PyGTK >= 2.10 * PyGTK >= 2.10
----
Diffuse is implemented entirely in Python and should run on any platform with Diffuse is implemented entirely in Python and should run on any platform with
Python and PyGTK. If you need to manually install PyGTK, please be aware its Python and PyGTK. If you need to manually install PyGTK, please be aware its
@ -42,47 +41,41 @@ The location of the personal preferences, state, and initialisation files have
changed in the 0.4.1 release. Old settings may be migrated using the following changed in the 0.4.1 release. Old settings may be migrated using the following
commands: commands:
$ mkdir -p ~/.config/diffuse $ mkdir -p ~/.config/diffuse
$ mv ~/.diffuse/config ~/.config/diffuse/state $ mv ~/.diffuse/config ~/.config/diffuse/state
$ mv ~/.diffuse/* ~/.config/diffuse $ mv ~/.diffuse/* ~/.config/diffuse
$ rmdir ~/.diffuse $ rmdir ~/.diffuse
The rules for parsing files in ~/.diffuse changed in the 0.3.0 release. The rules for parsing files in `~/.diffuse` changed in the 0.3.0 release.
Non-fatal errors may be reported when parsing old files. These errors can be Non-fatal errors may be reported when parsing old files. These errors can be
fixed by removing the offending lines (or the entire file) from fixed by removing the offending lines (or the entire file) from
~/.config/diffuse/diffuserc. `~/.config/diffuse/diffuserc`.
---- ## Installing on POSIX systems
Installing on POSIX systems: Run the `install.py` script to install Diffuse. The script accepts several
options for customising the installation behaviour. Use the `--help` option
Run the 'install.py' script to install Diffuse. The script accepts several
options for customising the installation behaviour. Use the '--help' option
to obtain a full listing. to obtain a full listing.
Diffuse can be removed by running the 'install.py' script with the '--remove' Diffuse can be removed by running the `install.py` script with the `--remove`
option. option.
Specify the '--destdir=' and '--files-only' options for the 'install.py' Specify the `--destdir=` and `--files-only` options for the `install.py`
script when using it to build a platform specific package of Diffuse. script when using it to build a platform specific package of Diffuse.
---- ## Installing on Windows
Installing on Windows: The `windows-installer` directory contains scripts for building an installable
The 'windows-installer' directory contains scripts for building an installable
package for Windows that includes all dependencies. package for Windows that includes all dependencies.
Diffuse can be packaged as a portable application by copying the installation Diffuse can be packaged as a portable application by copying the installation
directory to a pen drive and creating a front end that sets the XDG_CONFIG_HOME directory to a pen drive and creating a front end that sets the
and XDG_DATA_DIR environment variables prior to launching Diffuse. The `XDG_CONFIG_HOME` and `XDG_DATA_DIR` environment variables prior to launching
XDG_CONFIG_HOME and XDG_DATA_DIR environment variables indicate where Diffuse Diffuse. The `XDG_CONFIG_HOME` and `XDG_DATA_DIR` environment variables
should store persistent settings (eg. the path to a writable directory on the indicate where Diffuse should store persistent settings (eg. the path to a
pen drive). writable directory on the pen drive).
---- ## Help Documentation
Help Documentation:
Diffuse's help documentation is written in the DocBook format and can be easily Diffuse's help documentation is written in the DocBook format and can be easily
converted into other formats using XSLT stylesheets. If the local help converted into other formats using XSLT stylesheets. If the local help