From f937fefbc0fd8742fdb42bc4e5b0b365f4f561fc Mon Sep 17 00:00:00 2001
From: Miguel de Benito <nonick@8027.org>
Date: Fri, 21 Sep 2012 20:42:55 +0000
Subject: [PATCH] Links now accept web-style parameters (generic-file format).
 In progress.

---
 devel/scheme/api/link.en.tm | 41 +++++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)
 create mode 100644 devel/scheme/api/link.en.tm

diff --git a/devel/scheme/api/link.en.tm b/devel/scheme/api/link.en.tm
new file mode 100644
index 0000000..9d86ee8
--- /dev/null
+++ b/devel/scheme/api/link.en.tm
@@ -0,0 +1,41 @@
+<TeXmacs|1.0.7.15>
+
+<style|tmdoc>
+
+<\body>
+  <tmdoc-title|The link system>
+
+  There is currently no comprehensive documentation for the link system. In
+  the meantime, we'll collect here documentation for procedures related to
+  it.
+
+  <\explain>
+    <scm|(go-to-url <scm-arg|u> . <scm-arg|opt-from>)><explain-synopsis|Jump
+    to the url @u>
+  <|explain>
+    Opens a new buffer with the contents of the resource at <scm-arg|u>. This
+    can be either a full <abbr|URL> or a file path, absolute or relative to
+    the current <scm|buffer-master>. Both types of argument accept
+    parameters. The second, optional argument, is an optional path for the
+    cursor history.
+
+    You can pass paramenters in <scm-arg|u> in two ways: appending a hash
+    <tt|#> and some text, like in <tt|some/path/some-file.tm#blah> will open
+    the file and jump to the first label of name <tt|blah> found, if any. The
+    other possibility is the usual way in the web: append a question mark
+    <tt|?> followed by pairs <tt|parameter=value>. Currently the parameters
+    <tt|line> and <tt|column> are supported by default for any file of format
+    <scm|generic-file> (see <scm|define-format>).
+  </explain>
+
+  \;
+
+  <tmdoc-copyright|2012|the <TeXmacs> team.>
+
+  <tmdoc-license|Permission is granted to copy, distribute and/or modify
+  this\ndocument under the terms of the GNU Free Documentation License,
+  Version 1.1 or\nany later version published by the Free Software
+  Foundation; with no Invariant\nSections, with no Front-Cover Texts, and
+  with no Back-Cover Texts. A copy of\nthe license is included in the section
+  entitled "GNU Free Documentation License".>
+</body>
\ No newline at end of file