aboutsummaryrefslogtreecommitdiffstats
path: root/admin/notes
diff options
context:
space:
mode:
authorJoakim Verona2013-07-02 22:46:17 +0200
committerJoakim Verona2013-07-02 22:46:17 +0200
commit3718127221fbbc31f8ebd027ab7c95403dbe9118 (patch)
treeef422898f3344c8f94f6ecf63eb583122bbf2bd8 /admin/notes
parent1ce45b902c67b8a0dda8d71bd2812de29a9988a6 (diff)
parenta3b49114c186d84404226af75ae7905bd1cd018f (diff)
downloademacs-3718127221fbbc31f8ebd027ab7c95403dbe9118.tar.gz
emacs-3718127221fbbc31f8ebd027ab7c95403dbe9118.zip
Merge branch 'trunk' into xwidget
Conflicts: src/window.c
Diffstat (limited to 'admin/notes')
-rw-r--r--admin/notes/changelogs5
-rw-r--r--admin/notes/www82
2 files changed, 85 insertions, 2 deletions
diff --git a/admin/notes/changelogs b/admin/notes/changelogs
index 2e954570ce8..ae9ce40aa0a 100644
--- a/admin/notes/changelogs
+++ b/admin/notes/changelogs
@@ -3,8 +3,9 @@ entry in their name, not yours.
3 3
4 4
5http://lists.gnu.org/archive/html/emacs-devel/2007-09/msg00793.html 5http://lists.gnu.org/archive/html/emacs-devel/2007-09/msg00793.html
6 There is no need to make change log entries for files such as NEWS, 6http://lists.gnu.org/archive/html/emacs-devel/2013-06/msg00485.html
7 MAINTAINERS, and FOR-RELEASE. 7 There is no need to make trivial change log entries for files such
8 as NEWS, MAINTAINERS, and FOR-RELEASE.
8 9
9http://lists.gnu.org/archive/html/emacs-devel/2006-12/msg01135.html 10http://lists.gnu.org/archive/html/emacs-devel/2006-12/msg01135.html
10 There is no need to indicate regeneration of files such as configure 11 There is no need to indicate regeneration of files such as configure
diff --git a/admin/notes/www b/admin/notes/www
new file mode 100644
index 00000000000..0bb0850af0d
--- /dev/null
+++ b/admin/notes/www
@@ -0,0 +1,82 @@
1-*- outline -*-
2
3Copyright (C) 2013 Free Software Foundation, Inc.
4See the end of the file for license conditions.
5
6NOTES FOR EMACS WWW PAGES
7
8* Renaming pages, redirects
9
10Sometimes you want to move a page to a new location.
11If the old location might be referenced somewhere else, you should add
12some form of redirect to the new location. There are several ways to
13do this:
14
15** Use a refresh directive in the old file
16https://www.gnu.org/server/standards/README.webmastering.html#htaccess
17
18Change the entire contents of the old file to be something like:
19
20<meta http-equiv="refresh" content="0; url=/software/emacs/manual/elisp.html">
21
22I can't think of any reason to use this method.
23
24** Use a .symlinks file
25https://www.gnu.org/server/standards/README.webmastering.html#symlinks
26
27This is really an interface to mod_rewrite rules, but it acts like
28symlinks. Remove old-page.html altogether, and create a ".symlinks"
29file in the relevant directory, with contents of the form:
30
31 # This is a comment line.
32 old-page.html new-page.html
33
34Anyone visiting old-page.html will be shown the contents of new-page.html.
35Note that changes to .symlinks file are only updated periodically on
36the server via cron (twice an hour?). So there will be a delay (of up
37to 30 minutes?) before you see your changes take effect.
38
39This method is ok, but:
40i) a person visiting old-page.html has no idea that the page has moved.
41They still see old-page.html in their address bar. (In other words,
42the mod_rewrite rule does not use the [R] flag.) Sometimes this is
43what you want, sometimes not.
44
45ii) it doesn't work right if the new page is in a different directory
46to the old page: relative links from the visited page will break.
47
48** Use a .htaccess file
49
50Remove old-page.html altogether, and create a ".htaccess" file in the
51relevant directory, with contents of the form:
52
53 # This is a comment line.
54 Redirect 301 /software/emacs/old-page.html /software/emacs/dir/new-page.html
55
56Use "301" for a permanent redirection, otherwise you can omit the number.
57Note that paths must (?) be relative to the top-level www.gnu.org.
58
59I think this is the best method. You can specify temporary or
60permanent redirects, and changes go live more-or-less straight away.
61
62This method is useful for making cross-references to non-Emacs manuals
63work; see manual/.htaccess in the repository. You only have to add a
64single redirect for every given external manual, you can redirect
65html_node to hmtl_node and html_mono to html_mono.
66
67
68
69This file is part of GNU Emacs.
70
71GNU Emacs is free software: you can redistribute it and/or modify
72it under the terms of the GNU General Public License as published by
73the Free Software Foundation, either version 3 of the License, or
74(at your option) any later version.
75
76GNU Emacs is distributed in the hope that it will be useful,
77but WITHOUT ANY WARRANTY; without even the implied warranty of
78MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
79GNU General Public License for more details.
80
81You should have received a copy of the GNU General Public License
82along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.