1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72
|
Description: remove mentions of xmlada-config in documentation
The tool has been fully removed.
Author: Nicolas Boulenguez <nicolas@debian.org>
Forwarded: https://github.com/AdaCore/xmlada/pull/4
--- a/docs/using.rst
+++ b/docs/using.rst
@@ -10,62 +10,11 @@
There are several ways to do it:
-.. index:: xmlada-config
-
-* The simplest is to use the *xmlada-config* script, and let it
- provide the list of switches for *gnatmake*. This is more
- convenient on Unix systems, where you can simply compile your application
- with::
-
- gnatmake main.adb `xmlada-config`
-
- Note the use of backticks. This means that *xmlada-config* is
- first executed, and then the command line is replaced with the output of
- the script, thus finally executing something like::
+* The oldest relies on *gnatmake*. You compile your application with
+ something like::
gnatmake main.adb -Iprefix/include/xmlada -largs -Lprefix/lib \\
-lxmlada_input_sources -lxmlada_sax -lxmlada_unicode -lxmlada_dom
-
-
- Unfortunately, this behavior is not available on Windows (unless of course
- you use a Unix shell). The simplest in that case is to create a
- :file:`Makefile`, to be used with the *make* command, and copy-paste
- the output of *xmlada-config* into it.
-
- *xmlada-config* has several switches that might be useful:
-
-
- * *--sax*: If you this flag, your application will not be
- linked against the DOM module. This might save some space, particularly
- if linking statically.
-
- * *--static*: Return the list of flags to use to link your
- application statically against Xml/Ada. Your application is then
- standalone, and you don't need to distribute XMl/Ada at the same time.
-
- * *--static_sax*: Combines both of the above flags.
-
-
- If you are working on a big project, particularly one that includes
- sources in languages other than Ada, you generally have to run the three
- steps of the compilation process separately (compile, bind and then link).
- *xmlada-config* can also be used, provided you use one of the
- following switches:
-
-
- * *--cflags*: This returns the compiler flags only, to be used
- for instance with *gcc*.
-
- * *--libs*: This returns the linker flags only, to be used for
- instance with *gnatlink*.
-
-
- This *xmlada-config* method doesn't provide access to the
- :file:`xml_gtk` module, which is only available when using project files
- (see below).
-
- .. index:: project files
- .. index:: xmlada.gpr
* The preferred method, however, is to use the GNAT project files.
See the GNAT user's guide for more information on the project files and
|