4 From: Bram Moolenaar <Bram@moolenaar.net>
6 Content-Type: text/plain; charset=ISO-8859-1
7 Content-Transfer-Encoding: 8bit
11 Problem: The "help-tags" tag may be missing from runtime/doc/tags when it
12 was generated during "make install".
13 Solution: Add the "++t" argument to ":helptags" to force adding the tag.
14 Files: runtime/doc/Makefile, runtime/doc/various.txt, src/ex_cmds.c,
18 *** ../vim-7.1.216/runtime/doc/Makefile Sat May 5 19:14:15 2007
19 --- runtime/doc/Makefile Fri Jan 11 20:55:34 2008
22 # Use Vim to generate the tags file. Can only be used when Vim has been
23 # compiled and installed. Supports multiple languages.
25 ! $(VIMEXE) -u NONE -esX -c "helptags ." -c quit
27 # Use "doctags" to generate the tags file. Only works for English!
30 # Use Vim to generate the tags file. Can only be used when Vim has been
31 # compiled and installed. Supports multiple languages.
33 ! $(VIMEXE) -u NONE -esX -c "helptags ++t ." -c quit
35 # Use "doctags" to generate the tags file. Only works for English!
37 *** ../vim-7.1.216/runtime/doc/various.txt Sat May 12 17:05:26 2007
38 --- runtime/doc/various.txt Fri Jan 11 20:45:45 2008
41 ! *various.txt* For Vim version 7.1. Last change: 2007 Jan 14
44 VIM REFERENCE MANUAL by Bram Moolenaar
46 ! *various.txt* For Vim version 7.1. Last change: 2008 Jan 11
49 VIM REFERENCE MANUAL by Bram Moolenaar
54 *E154* *E150* *E151* *E152* *E153* *E670*
55 ! :helpt[ags] {dir} Generate the help tags file(s) for directory {dir}.
56 All "*.txt" and "*.??x" files in the directory are
57 scanned for a help tag definition in between stars.
58 The "*.??x" files are for translated docs, they
62 *E154* *E150* *E151* *E152* *E153* *E670*
63 ! :helpt[ags] [++t] {dir}
64 ! Generate the help tags file(s) for directory {dir}.
65 All "*.txt" and "*.??x" files in the directory are
66 scanned for a help tag definition in between stars.
67 The "*.??x" files are for translated docs, they
71 The generated tags files are sorted.
72 When there are duplicates an error message is given.
73 An existing tags file is silently overwritten.
74 + The optional "++t" argument forces adding the
75 + "help-tags" tag. This is also done when the {dir} is
76 + equal to $VIMRUNTIME/doc.
77 To rebuild the help tags in the runtime directory
78 (requires write permission there): >
79 :helptags $VIMRUNTIME/doc
80 *** ../vim-7.1.216/src/ex_cmds.c Wed Jan 9 22:39:55 2008
81 --- src/ex_cmds.c Fri Jan 11 20:47:13 2008
86 #if defined(FEAT_EX_EXTRA) || defined(PROTO)
87 ! static void helptags_one __ARGS((char_u *dir, char_u *ext, char_u *lang));
94 #if defined(FEAT_EX_EXTRA) || defined(PROTO)
95 ! static void helptags_one __ARGS((char_u *dir, char_u *ext, char_u *lang, int add_help_tags));
105 + int add_help_tags = FALSE;
107 + /* Check for ":helptags ++t {dir}". */
108 + if (STRNCMP(eap->arg, "++t", 3) == 0 && vim_iswhite(eap->arg[3]))
110 + add_help_tags = TRUE;
111 + eap->arg = skipwhite(eap->arg + 3);
114 if (!mch_isdir(eap->arg))
121 ! helptags_one(eap->arg, ext, fname);
129 ! helptags_one(eap->arg, ext, fname, add_help_tags);
137 /* No language support, just use "*.txt" and "tags". */
138 ! helptags_one(eap->arg, (char_u *)".txt", (char_u *)"tags");
143 ! helptags_one(dir, ext, tagfname)
144 ! char_u *dir; /* doc directory */
145 ! char_u *ext; /* suffix, ".txt", ".itx", ".frx", etc. */
146 ! char_u *tagfname; /* "tags" for English, "tags-it" for Italian. */
153 /* No language support, just use "*.txt" and "tags". */
154 ! helptags_one(eap->arg, (char_u *)".txt", (char_u *)"tags", add_help_tags);
159 ! helptags_one(dir, ext, tagfname, add_help_tags)
160 ! char_u *dir; /* doc directory */
161 ! char_u *ext; /* suffix, ".txt", ".itx", ".frx", etc. */
162 ! char_u *tagfname; /* "tags" for English, "tags-fr" for French. */
163 ! int add_help_tags; /* add "help-tags" tag */
172 ! * If generating tags for "$VIMRUNTIME/doc" add the "help-tags" tag.
174 ga_init2(&ga, (int)sizeof(char_u *), 100);
175 ! if (fullpathcmp((char_u *)"$VIMRUNTIME/doc", dir, FALSE) == FPC_SAME)
177 if (ga_grow(&ga, 1) == FAIL)
183 ! * If using the "++t" argument or generating tags for "$VIMRUNTIME/doc"
184 ! * add the "help-tags" tag.
186 ga_init2(&ga, (int)sizeof(char_u *), 100);
187 ! if (add_help_tags || fullpathcmp((char_u *)"$VIMRUNTIME/doc",
188 ! dir, FALSE) == FPC_SAME)
190 if (ga_grow(&ga, 1) == FAIL)
192 *** ../vim-7.1.216/src/ex_cmds.h Thu Mar 8 11:00:55 2007
193 --- src/ex_cmds.h Fri Jan 11 20:49:18 2008
196 EX(CMD_helpgrep, "helpgrep", ex_helpgrep,
197 EXTRA|NOTRLCOM|NEEDARG),
198 EX(CMD_helptags, "helptags", ex_helptags,
199 ! NEEDARG|FILE1|TRLBAR|CMDWIN),
200 EX(CMD_hardcopy, "hardcopy", ex_hardcopy,
201 RANGE|COUNT|EXTRA|TRLBAR|DFLALL|BANG),
202 EX(CMD_highlight, "highlight", ex_highlight,
204 EX(CMD_helpgrep, "helpgrep", ex_helpgrep,
205 EXTRA|NOTRLCOM|NEEDARG),
206 EX(CMD_helptags, "helptags", ex_helptags,
207 ! NEEDARG|FILES|TRLBAR|CMDWIN),
208 EX(CMD_hardcopy, "hardcopy", ex_hardcopy,
209 RANGE|COUNT|EXTRA|TRLBAR|DFLALL|BANG),
210 EX(CMD_highlight, "highlight", ex_highlight,
211 *** ../vim-7.1.216/src/version.c Fri Jan 11 20:25:42 2008
212 --- src/version.c Fri Jan 11 20:58:44 2008
216 { /* Add new patch number below this line */
222 My girlfriend told me I should be more affectionate.
223 So I got TWO girlfriends.
225 /// Bram Moolenaar -- Bram@Moolenaar.net -- http://www.Moolenaar.net \\\
226 /// sponsor Vim, vote for features -- http://www.Vim.org/sponsor/ \\\
227 \\\ download, build and distribute -- http://www.A-A-P.org ///
228 \\\ help me help AIDS victims -- http://ICCF-Holland.org ///