Skip to content
This repository has been archived by the owner on Mar 11, 2019. It is now read-only.

Change README to Markdown format #58

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 9 additions & 8 deletions README → README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,16 @@ This repository provides Vala bindings to various libraries which do
not provide their own bindings, and for which valac does not provide
bindings.

== Rationale ==
## Rationale

In most cases it is preferable for libraries to ship their own
bindings (some of the reasons why, as well as information on how to do
so, are at http://live.gnome.org/Vala/UpstreamGuide). Some libraries,
however, are unable or unwilling to do so. Other bindings are
distributed with valac, but generally that is reserved for relatively
popular libraries with well structured VAPIs and have a fairly strong
aversion to breaking backwards compatibility.
so, are at Vala Binding's
[Upstream Guide](https://wiki.gnome.org/Projects/Vala/UpstreamGuide).
Some libraries, however, are unable or unwilling to do so. Other
bindings are distributed with valac, but generally that is reserved
for relatively popular libraries with well structured VAPIs and have
a fairly strong aversion to breaking backwards compatibility.

Bindings included in this repository are meant to be copied into your
project or used as a git submodule or subtree, and are *not* intended
Expand All @@ -28,15 +29,15 @@ bindings, preserving backwards compatibility, testing, etc. With that
in mind, this repository provides a good stable, central location for
bindings.

== Usage ==
## Usage

Because the bindings shipped in this repository provide no
backwards-compatibility promises, it is designed to be used as a git
submodule. If that is not acceptable (for example, if you don't use
git), it is recommended you simply copy the bindings you need into
your source tree.

== Submitting Bindings For Inclusion ==
## Submitting Bindings For Inclusion

If you have bindings which you would like to see housed in this
repository, simply submit a bug to the "Bindings: Extra" component in
Expand Down