Rename the platform updating script, distribute it and document it

git-svn-id: svn+ssh://scm.gforge.inria.fr/svn/simgrid/simgrid/trunk@5134 48e7efb5-ca39-0410-a469-dd3cf9ba447f

diff --git a/doc/FAQ.doc b/doc/FAQ.doc
index a52ee0b..ecba2a4 100644 (file)
--- a/doc/FAQ.doc
+++ b/doc/FAQ.doc
@@ -1131,15 +1131,20 @@ reason:
 
 \subsubsection faq_trouble_errors_big_fat_warning I'm told that my XML files are too old.
 
 
 \subsubsection faq_trouble_errors_big_fat_warning I'm told that my XML files are too old.
 

-We have decided to change the units in SimGrid. Now we use Bytes, Flops and
-seconds instead of MBytes, MFlops and seconds... Units should be updated
-accordingly and the version of platform_description should be set to a
-valuer greater than 1:
+The format of the XML platform description files is sometimes
+improved. For example, we decided to change the units used in SimGrid
+from MBytes, MFlops and seconds to Bytes, Flops and seconds to ease
+people exchanging small messages. We also reworked the route
+descriptions to allow more compact descriptions.
+
+That is why the XML files are versionned using the 'version' attribute
+of the root tag. Currently, it should read:

 \verbatim
 \verbatim

-  <platform_description version="1">
+  <platform version="2">

 \endverbatim
 \endverbatim

-You should try to use the surfxml_update.pl script that can be found
-<a href="https://gforge.inria.fr/plugins/scmsvn/viewcvs.php/contrib/trunk/platform_generation/?rev=4721&root=simgrid"">here</a>.
+
+If your files are too old, you can use the simgrid_update_xml.pl
+script which can be found in the tools directory of the archive.

 
 \subsection faq_trouble_valgrind Valgrind-related issues
 
 
 \subsection faq_trouble_valgrind Valgrind-related issues
 

diff --git a/tools/Makefile.am b/tools/Makefile.am
index d293812..d14d8d2 100644 (file)
--- a/tools/Makefile.am
+++ b/tools/Makefile.am
@@ -4,10 +4,9 @@
 # You can redistribute and/or modify it under the terms of the
 # GNU LGPL (v2.1) licence.
 
 # You can redistribute and/or modify it under the terms of the
 # GNU LGPL (v2.1) licence.
 

-

 SUBDIRS=gras tesh
 include $(top_srcdir)/acmacro/dist-files.mk
 if GRAMINE_MODE
 else
 SUBDIRS=gras tesh
 include $(top_srcdir)/acmacro/dist-files.mk
 if GRAMINE_MODE
 else

-EXTRA_DIST= graspe-master
+EXTRA_DIST= simgrid_update_xml.pl graspe-master

 endif
 endif

diff --git a/tools/Makefile.in b/tools/Makefile.in
index 7a1d64d..71d467b 100644 (file)
--- a/tools/Makefile.in
+++ b/tools/Makefile.in
@@ -211,7 +211,7 @@ target_vendor = @target_vendor@
 top_builddir = @top_builddir@
 top_srcdir = @top_srcdir@
 SUBDIRS = gras tesh
 top_builddir = @top_builddir@
 top_srcdir = @top_srcdir@
 SUBDIRS = gras tesh

-@GRAMINE_MODE_FALSE@EXTRA_DIST = graspe-master
+@GRAMINE_MODE_FALSE@EXTRA_DIST = simgrid_update_xml.pl graspe-master

 all: all-recursive
 
 .SUFFIXES:
 all: all-recursive
 
 .SUFFIXES:

diff --git a/tools/surfxml_update.pl b/tools/simgrid_update_xml.pl
similarity index 100%
rename from tools/surfxml_update.pl
rename to tools/simgrid_update_xml.pl