doc: rename diff_with_c-version to diff_v3_v4

Author: xdelaruelle

.gitignore

@@ -16,7 +16,7 @@
 /contrib/scripts/add.modules
 /contrib/modulefiles/modules
 /compat
-/doc/diff_with_c-version.txt
+/doc/diff_v3_v4.txt
 /doc/html/*.html
 /doc/man
 /doc/source/module.pod

NEWS

@@ -88,6 +88,10 @@ please see `MIGRATING`.
   * Install: update RPM spec file to handle compatibility version as a
     'compat' sub-package.
   * Add completion script for Fish shell (contribution from BEFH).
+  * Doc: extend content of diff_v3_v4 to details all noticeable changes
+    between v3.2 and v4.0.
+  * Doc: introduce MIGRATING guide to learn the major changes when moving
+    from v3.2 to v4.0.
 
 Above changes describe the differences with modules-tcl release 1.923. To
 learn about the changes between Modules 4.0 and last Modules 3.2 release,

contrib/rpm/environment-modules.spec

@@ -176,7 +176,7 @@ fi
 %else
 %license COPYING.GPLv2
 %endif
-%doc ChangeLog NEWS README MIGRATING doc/diff_with_c-version.txt
+%doc ChangeLog NEWS README MIGRATING doc/diff_v3_v4.txt
 %{_sysconfdir}/modulefiles
 %if 0%{?fedora}
 %ghost %{_sysconfdir}/profile.d/modules.csh

doc/Makefile

@@ -27,10 +27,10 @@ else
 man: $(MAN1_DIR)/module.1 $(MAN4_DIR)/modulefile.4
 endif
 
-txt: diff_with_c-version.txt
+txt: diff_v3_v4.txt
 
 html: $(HTML_DIR)/module.html $(HTML_DIR)/modulefile.html \
-	$(HTML_DIR)/diff_with_c-version.html
+	$(HTML_DIR)/diff_v3_v4.html
 
 all: html man txt
 
@@ -71,7 +71,7 @@ install: all
 	mkdir -p $(DESTDIR)$(mandir)/man1 $(DESTDIR)$(mandir)/man4
 ifeq ($(docinstall),y)
 	mkdir -p $(DESTDIR)$(docdir)
-	cp diff_with_c-version.txt $(DESTDIR)$(docdir)/
+	cp diff_v3_v4.txt $(DESTDIR)$(docdir)/
 	cp example.txt $(DESTDIR)$(docdir)/
 endif
 	cp $(MAN1_DIR)/module.1 $(DESTDIR)$(mandir)/man1/
@@ -83,7 +83,7 @@ endif
 
 uninstall:
 ifeq ($(docinstall),y)
-	rm -f $(DESTDIR)$(docdir)/diff_with_c-version.txt
+	rm -f $(DESTDIR)$(docdir)/diff_v3_v4.txt
 	rm -f $(DESTDIR)$(docdir)/example.txt
 	rmdir $(DESTDIR)$(docdir)
 endif
@@ -109,5 +109,5 @@ endif
 ifneq ($(wildcard $(MAN_DIR)),)
 	rmdir $(MAN_DIR)
 endif
-	rm -f diff_with_c-version.txt
+	rm -f diff_v3_v4.txt
 	rm -f pod*.tmp

doc/source/diff_with_c-version.pod renamed to doc/source/diff_v3_v4.pod

@@ -1,4 +1,4 @@
-=head1 Slight differences between versions 3.2 and 4
+=head1 Differences between versions 3.2 and 4
 
 This document lists functionality differences between Modules version 3.2 and Modules version 4. Modules version 3.2 is also referred in this document as I<compatibility version> whereas Modules version 4 is also referred as I<new main version>. Modules version 4 is based on what was previously called Modules-Tcl. The goal of this document is to reference the features of the compatibility version that are missing or behave differently on the new main version and the features that can only be found on this new version.