[beast: 5/17] DOCS: bse.5.md: convert imports/bse.5 to markdown

[Tim Janik <timj src gnome org>]

commit 275f56ceab65c2ae5f195e6ac9474b62d3c43968
Author: Tim Janik <timj gnu org>
Date:   Sun Mar 19 02:25:50 2017 +0100

    DOCS: bse.5.md: convert imports/bse.5 to markdown
    
    Signed-off-by: Tim Janik <timj gnu org>

 docs/bse.5.md |   41 +++++++++++++++++++++++++++++++++++++++++
 1 files changed, 41 insertions(+), 0 deletions(-)
---
diff --git a/docs/bse.5.md b/docs/bse.5.md
new file mode 100644
index 0000000..d2e2903
--- /dev/null
+++ b/docs/bse.5.md
@@ -0,0 +1,41 @@
+% BSE(5) Beast-@BUILDID@ | Beast/Bse Manual
+%
+% @FILE_REVISION@
+
+# NAME
+BSE - Better Sound Engine File Format
+
+# SYNOPSIS
+*filename*.**bse**
+
+# DESCRIPTION
+
+The **Bse** file format is used by the **Bse** library and dependent programs to save
+projects, songs, instruments and sample collections.
+The Bse scheme shell [**bsescm.1**](bsescm.1.html "bsescm.1") is able to play back
+**Bse** files directly.
+
+# FORMAT
+
+Bse files start out with a special magic string `"; BseProject\n"` and then contain nested
+expressions in scheme syntax using the ASCII charset.
+Binary data may be appended to a `*.bse` file if it is separated from the preceeding
+ASCII text by one or more literal NUL characters (`'\0'`).
+This mechanism is used to store arbitrary binary data like *WAV* or *Ogg/Vorbis* files
+in Bse projects, while keeping the actual content user editable - text editors that
+preserve binary sections have to be used, such as **vi(1)** or **emacs(1)**.
+
+# COMPATIBILITY
+
+The exact format and sets of objects and properties used in a Bse file depend highly
+on the library version that was used to save the file. Compatibility functions are supplied
+by the library itself, so old Bse files can be converted when the file is loaded.
+To enable this mechanism, all Bse files contain a `"bse-version"` directive which
+indicates the  Bse file format version of the supplied content.
+
+# SEE ALSO
+
+[**beast(1)**](beast.1.html),
+[**bsescm(1)**](bsescm.1.html),
+[**bsewavetool(1)**](bsewavetool.1.html),
+[**BSE Reference**](https://testbit.eu/pub/docs/beast/latest/namespaceBse.html){.external}