-
Notifications
You must be signed in to change notification settings - Fork 3
/
Copy pathNEWS
2409 lines (1925 loc) · 83.5 KB
/
NEWS
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
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
___________________________________
| | | | | _ | | |
| |___| | | | | _| | | | GNU GLOBAL source code tagging system
| | | | | | | | | |
| ~~ | ~~| | ~ | | | ~~| for all hackers.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Copyright (c) 2000-2018 Tama Communications Corporation
This file is free software; as a special exception the author gives
unlimited permission to copy and/or distribute it, with or without
modifications, as long as this notice is preserved.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY, to the extent permitted by law; without even the
implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
----------------------------------
GNU GLOBAL NEWS - User visible changes.
At least, you should search '[INCOMPATIBLE CHANGES]' for each version.
Version 6.6.3 - December 17 2018
[CHANGES]
New facilities:
o gtags: New --skip-symlink option.
This option skips symbolic links.
--skip-symlink[=type]
If type is 'f' then skip only symbolic links for file, else if 'd' then skip
only symbolic links for directory. The default value is 'a' (all symbolic links).
o gtags-cscope: 'Find assignments to this symbol:' was implemented.
In vim, you can use it as ':cs find a <pattern>' or ':cs find 9 <pattern>'.
o gtags-cscope.vim: the following key assignment was added.
<C-\>a, <C-@>a, <C-@><C-@>a
[FIXED BUGS]
o pygments_parser.py.in: This plug-in parser failed with the handling of file names
with mixed case on Windows. Now it works.
o gtags-cscope: Fixed a wrong description in the online manual.
Find this function definition: -> Find this global definition:
Version 6.6.2 - February 9 2018
[INCOMPATIBLE CHANGES]
o gozilla: Deleted the following undocumented functions to reduce or eliminate
possibility of future security risks. These were inherently unnecessary as
source code tagging system.
$HOME/.gozillarc
Alias file. Please read the source code for details.
BUGS
Gozilla can accept not only source files but also text files,
directories, HTML files and even URLs, because it is omnivorous.
[FIXED BUGS]
o geco.rc: gecoless always failed with a message 'geco: percol, peco or fzf is required.'
Now, it works.
o gtags-cscope: did not accept function '9' in the line mode. This caused vim8 to hang.
Now it accepts function '9' and reports an error message.
Version 6.6.1 - December 16 2017
[FIXED BUG]
o gozilla: A critical vulnerability (CVE-2017-17531) was found in a unknown
function of gozilla(1). It allows remote attackers to execute arbitrary
code via a crafted URL. All gozilla(1) before GLOBAL-6.6.1 have the vulnerability.
Now it is fixed.
- What is the unknown function?
Gozilla accepts a URL as an argument, and invokes a web browser with the URL.
Though it is undocumented, it is implied in the online manual as follows:
> BUGS
> Gozilla can accept not only source files but also text files,
> directories, HTML files and even URLs, because it is omnivorous.
Version 6.6 - December 12 2017
[CHANGES]
New facilities:
o gtags: Added support for glob patterns in langmap variable in gtags.conf(5).
Now, you can treat source files without extension like ctags(1).
(e.g. :langmap=Make\:.mak.mk([Mm]akefile):)
Changed:
o gozilla: Changed the default browser from 'mozilla' to 'firefox'.
o gtags.conf.in: Updated to adapt to the latest ctags(s).
Removed: common-ctags-maps
Updated: exuberant-ctags, universal-ctags
[INCOMPATIBLE CHANGES]
o universal-ctags.la: The --extra option in Exuberant-ctags is renamed
to --extras (plural) in Universal-ctags for making consistent with
--kinds-<LANG> and --fields.
[FIXED BUGS]
o gtags: (parser error) picked up a typedef name as both of definition
and reference. Now it works.
Input:
[a.h]
typedef struct a A;
$ global -x A
A 1 a.h typedef struct a A;
$ global -x A -r
(global-6.5.7)
A 1 a.h typedef struct a A;
(global-6.6)
no output
o global: the -i option does not work correctly in some conditions.
Now it works.
o global: didn't accept pattern as a string literal with the --from-here
option, even if the --literal option was specified. Now, global(1)
accepts pattern as a string literal with the --literal option.
o libdb: there was 4 Gbyte limitation on the system where `off_t' is 64 bits
and `long' is 32 bits. Now it is eliminated.
o libparser: php parser was not reset state for each source file.
So, it was producing unintelligible results. Now it is fixed.
o gozilla: with wrong argument caused segmentation violation.
$ gozilla -d
Segmentation fault: 11
Now it displays usage.
Version 6.5.7 - 15 May 2017
[CHANGES]
o global: Now global(1) accept a file as --nearness option.
If it is a file, tags in the file are shown first.
o global: Added aliases for MAKEOBJDIR and MAKEOBJDIRPREFIX.
GTAGSOBJDIR: alias for MAKEOBJDIR
GTAGSOBJDIRPREFIX: alias for MAKEOBJDIRPREFIX
These aliases are given higher priority than the originals.
o global: New command --print=<name>.
<name> may be one of: root, dbpath or conf.
This is a generic version of the -p (--print-dbpath) command.
'global -p' is equal to 'global --print=dbpath'
'global -pr' is equal to 'global --print=root'
o gtags: Updated the built-in PHP parser to support namespaces and traits,
which were introduced in PHP5. The following keywords have been removed:
- failure: not a keyword
- header: normal built-in function
- is_array: normal built-in function
- is_set: typo -> isset
- printf: normal built-in function
- setcookie: normal built-in function
- success: not a keyword
[FIXED BUGS]
o globash: Echo command with -n option didn't work on some OS. Now it works.
o global: The --nearness option without -x option brought segmentation fault.
$ global --nearness=. main
Segmentation fault: 11
Now it works.
o global: --from-here with -i option did not ignore case of function name
in the context. Now it works.
Input:
[main.c]
1: main() {
2: func();
3: Func();
4: }
5: func() {}
6: Func() {}
$ global -xi --from-here=6:main.c func
(global-6.5.6)
Func 6 main.c Func() {}
func 5 main.c func() {}
(global-6.5.7)
Func 3 main.c Func();
func 2 main.c func();
[INCOMPATIBLE CHANGES]
o gtags.conf: Added new candidate path.
(1) --gtagsconf file
(2) $GTAGSCONF
(3) [project root]/gtags.conf
(4) [project root]/[objdir]/gtags.conf <- [NEW]
(5) $HOME/.globalrc
(6) /etc/gtags.conf
(7) [sysconfdir]/gtags.conf
The default of [objdir] is 'obj'. You can change it by
the environment variables (GTAGSOBJDIR or MAKEOBJDIR).
Version 6.5.6 - December 19 2016
[CHANGES]
New facilities:
o htags-server: New --retry[=n] option.
If the port is already in use, retry n times with incrementing the port number.
The default of n is 20.
o htags: Changed the format of function header (--show-position) to make copying
text easier.
o geco.rc: Added 'fzf' as a selector candidate.
o gtags: New configuration variable 'gtags_hook'.
gtags_hook=<command line>
Specify a command line which should be executed at the beginning of gtags(1).
Leading "./" in any path is always means the project root directory, since
gtags(1) is always invoked there.
GTAGS_COMMANDLINE environment variable (read only)
You can get the effective command line of gtags(1) from the hook. It includes
both $GTAGS_OPTIONS and real arguments.
[Usage]
You can update 'gtags.files' before gtags(1) read it.
[gtags.conf]
+----------------------------------------
|...
|:gtags_hook=find src lib -print >gtags.files:
You can refer the effective arguments of gtags(1) from the hook using
environment variable GTAGS_COMMANDLINE.
[gtags.conf]
+----------------------------------------
|...
|:gtags_hook=./gen.sh:\
|:GTAGS_OPTIONS=-c:\
[gen.sh]
+----------------------------------------
|#!/bin/sh
|echo ">>> $GTAGS_COMMANDLINE" # show effective command line
$ gtags -O
>>> gtags -c -O
$ _
[INCOMPATIBLE CHANGES]
o htags: Now --cvsweb option always insert 'view=log' to the generated URLs.
Because it seems to be almost always a desirable specification.
[FIXED BUGS]
o gtags: Gtags often aborts with a message "buffer overflow. strlimcpy" when
it encounters a long token (> 152 bytes). Now gtags always ignores it with
a message "symbol name is too long. (Ignored)".
o htags: Old packages included two CGI scripts (completion.cgi, global.cgi)
generated in the release manager's machine by mistake. They have some literal
path like '/opt/local/bin/perl' which works only with MacPorts.
Now, they are generated in the target (your) machine.
Version 6.5.5 - Sep 21 2016
This is a bug fix release.
[FIXED BUGS]
o exuberant-ctags.la: The path name of ctags command couldn't changed.
Now, it can be changed by configuration variable 'ctagscom'.
o Tag files got corrupted when the built-in C++ parser gave up parsing and aborted.
Now, it is avoided.
o Some inappropriate error messages were changed.
Error1: NULL file (file size == 0)
$ cp /dev/null GTAGS
$ global -x main
(GLOBAL-6.5.4) global: /tmp/test/GTAGS seems older format. Please remake tag files.
(GLOBAL-6.5.5) global: /tmp/test/GTAGS seems to be corrupted.
Error2: Corrupted file
$ echo aaa >GTAGS
$ global -x main
(GLOBAL-6.5.4) global: GTAGS not found.
(GLOBAL-6.5.5) global: /tmp/test/GTAGS seems to be corrupted.
Version 6.5.4 - Mar 27 2016
This is a bug fix release.
[CHANGES]
Changed:
o gtags.conf: The entries which include '.xml' were commented out,
because they require libxml.a. If you use them, please uncomment them.
[FIXED BUGS]
Serious bug:
o universal-ctags.la: Universal ctags plug-in parser did not work
on almost files. Now it works.
$ echo 'void a() {}' >a.inl
$ echo 'void b() {}' >b.cpp
$ gtags --gtagslabel=new-ctags
$ global -x '.*'
a 1 a.inl void a() {}
(b.cpp was ignored.)
Version 6.5.3 - Mar 18 2016
[CHANGES]
New facilities:
o Added new plug-in parser 'universal-ctags.la'.
o gtags.conf:
- Added new entry 'universal-ctags'.
- Added new variable 'ctagscom'. You can overwrite the path of ctags(1)
dynamically for exuberant-ctags.la, universal-ctags.la and pygments-parser.la.
Changed:
o gtags.conf: Added the following patterns to the skip list.
'*.o,*.a,*.so,*.lo,*.zip,*.gz,*.bz2,*.xz,*.lzh,*.Z,*.tgz,*.min.js,*min.css'
o gtags: Added some explanations for the --explain option.
[FIXED BUGS]
o global: Global generated incorrect path with the --color option.
Now, it works well.
[bad case]
+- GTAGS
+- hi/
|- foo.cpp
+- what/
$ cd hi/what
$ global -P hi/foo.cpp --color
foo.cpp # It should be '../foo.cpp'.
o global: Global aborted in obstack_free() in some cases. Now it works well.
o htags: Htags ended abnormally when there is a file which includes single
quote characters in its file name. Now, it works.
Version 6.5.2 - Dec 16 2015
[CHANGES]
New facilities:
o Improvements of gtags.conf
- Including from another file: Label syntax is expanded. (:tc=label[@file]:)
- Variable substitution: B shell like variable substitution is available.
- Addition of variables: 'bindir', 'datadir', 'libdir' and 'localstatedir'.
By default, these variables has a value given by the configure script.
- gtags.conf(5): Online manual of the configuration file.
o global: Now the -N(--nearness) option also works with the -P and -g command
as well as the tag search command.
o gtags.vim: New custom variable 'Gtags_Close_When_Single' (default 0).
If this variable is set to 1, quickfix window is closed when single tag.
Changed:
o gtags-cscope: Title changed to reduce misunderstanding.
Find locations calling this function: -> Find references of this function:
[FIXED BUGS]
o gtags.el: a strange error message in gtags-visit-rootdir was fixed.
$ cp /dev/null main.c
$ ls
main.c
$ emacs -f gtags-mode main.c
[Emacs mini buffer]
M-x gtags-visit-rootdir[ENTER]
Visit root directory: /tmp/test/[ENTER]
/tmp/test/main.c is not directory. <= STRANGE ERROR
o gtags (C, C++): Gtags couldn't handle enums in the case that there are
newlines between "enum" and " {". Now it can handle correctly.
+-------------
|typedef enum
|{
| E_FIRST = 1,
| E_SECOND
|} FIRST_SECOND;
+-------------
$ global -x '.*'
E_FIRST 3 test.h E_FIRST = 1,
FIRST_SECOND 5 test.h } FIRST_SECOND; <= E_SECOND not found
$ _
+-------------
|enum
|tag
|{ ... };
+-------------
$ global -x '.*'
$ _ <= tag not found
o gtags.conf: some part of a comment line (start with '#') was not skipped
when the line is very large. Now it is skipped correctly.
o gtags: If the DLL path includes ':', loading failed. Now it works.
Version 6.5.1 - Sep 15 2015
[CHANGES]
New facilities:
o gtags(c, c++): New environment variable GTAGSFORCEENDBLOCK.
If this variable is set, each '}' at the first column brings
end of all blocks.
o gtags: New --skip-unreadable option.
If this option is specified, gtags skips unreadable files
instead of exiting the command.
[FIXED BUGS]
o gtags: There was a difference of interpretation of the langmap
between gtags and ctags. Now there is no difference.
o gtags (C++): Gtags did not pick up 'my_type1' as a definition
in the following example:
[xxx.cpp]
+------------------------
|using my_type1 = double;
Now it picks up the symbol as a definition.
o gtags (C++): gtags picked up 'DomainId_t' as a definition
in the following example:
[xxx.cc]
+------------------------
|typedef std::map<DomainId_t, int> map_t2;
Now it does not pick up it as a definition.
o gtags (C, C++): Gtags did not pick up 'pr_debug' as a definition
in the following example:
[xxx.h]
+------------------------
|extern void dump_stack(void) __cold;
|#define pr_debug() printk()
Now it picks up it as a definition.
o gtags (PHP): Gtags did not treat back-quote correctly.
[xxx.php]
+------------------------
|<?php `ls $echo ~/*`; ?>
Now it works.
[INCOMPATIBLE CHANGES]
o gozilla: Now, gozilla invokes firefox as a generic browser, that is, using
command line 'firefox url'. Because firefox have removed the -remote command
since version 39.
Version 6.5 - June 10 2015
[CHANGES]
New facilities:
o global: New -N (--nearness=[start]) option.
Nearness sort method is available for the output of tag search command.
The result of nearness sort is concatenation of the followings ([1]-[n])
in this order. The default of 'start' is the current directory.
[1] Output of local search in the 'start' directory.
[2] Output of local search in the parent directory except for [1].
[3] Output of local search in the grandparent directory except for [1]-[2].
(repeat until the project root directory)
[n] Output of local search in the project root directory except for [1]-[n-1].
In each directory, they are sorted by alphabetical order.
o global: Now the --literal option also works with the tag search command,
-P command and -I command as well as the -g command.
[FIXED BUGS]
o htags: The -c and -x option of htags(1) were still available in the help
message, even though they had actually been removed. Now, these options
are removed completely.
o gtags (PHP): Against the following source code, gtags(1) aborted with a message
'short of memory'. Now it works.
[nullstring.php]
+----------------
|<?php
|define('');
|?>
+----------------
o gtags (C++): Gtags(1) didn't recognize the shift operator. Now it works.
[a.hh]
+----------------
|class const_mod<uint64_t(1) << 48>
|{
|};
+----------------
$ gtags
gtags: failed to parse template [+1 ./a.hh].
o gtags (C, C++): Gtags(1) couldn't pick up 'E2' as a definition. Now it works.
[test.c]
+----------------
|enum my_enum2
|{
| E2
|};
+----------------
Version 6.4 - March 24 2015
[CHANGES]
New facilities:
o gtags: Now --sqlite3 option is supported formally. This option uses
SQLite3 API instead of BSD/DB API for making tag files.
To use this option, you need to invoke configure script with
--with-sqlite3 in the build phase.
[configuration phase]
$ ./configure --with-sqlite3 # use sqlite3 API
[execution phase]
$ gtags --sqlite3 # make sqlite3 tag files
o gtags: --single-update option supports deletion of a file.
Now the next command line works well.
$ rm test.c
$ gtags --single-update=test.c
o gtags: New --explain option. This option explains handling files.
You can know the following information:
- Skipped reason for each skipped files.
- Used parser and its library path for each source file.
[FIXED BUGS]
o global: global(1) could not pick up source code from source files
in library projects (GTAGSLLIBPATH) if their tag files are compact
format. Now it works.
[INCOMPATIBLE CHANGES]
The following features of htags(1) were removed.
o The -c (--compact) option.
o The --system-cgi option.
o The --overwrite-key option.
o The -x (--xhtml[=version]) option.
All files are 1.0.
o The following configuration variables:
colorize-warned-line (substitute: --colorize-warned-line)
gzipped_suffix (substitute: not available)
htags_options (substitute: HTAGS_OPTIONS)
ncol (substitute: -n, --line-number [n])
normal_suffix (always '.html')
no_order_list (substitute: --no-order-list)
script_alias (substitute: not available)
tabs (substitute: --tabs n)
xhtml_version (always 1.0)
Version 6.3.4 - February 2 2015
[FIXED BUGS]
o global: Global(1) exited with a message "Abbrev character must be
a lower alphabetic character ()" in some condition. Now it is fixed.
o gozilla/Makefile.am: Installation made a directory outside of the DESTDIR.
Now it is fixed.
o gtags: The C++ parser picked up compiler specific macros as a class name.
It is not desirable. Now it is fixed.
Version 6.3.3 - November 26 2014
[CHANGES]
New facilities:
o Pygments plug-in parser: Support python 3.
o gozilla: added support of OSX's default browser.
Please set environment variable BROWSER to 'osx-default'.
$ htags --suggest --map-file
$ export BROWSER=osx-default
$ gozilla +120 main.c # shows line 120 in main.c
$ gozilla -d main # shows definitions of main()
o vim74-gtags-cscope.patch: New patch for vim + gtags-cscope to treat
file names which include spaces correctly. Please see README.PATCHES.
Release for beta test:
o Added --sqlite3 option which uses SQLite3 API instead of BSD/DB API for
making tag files.
[FIXED BUGS]
o gtags-cscope.vim: There was a calling to undefined function.
Now it works.
Version 6.3.2 - September 4 2014
[CHANGES]
New facilities:
o Pygments plug-in parser by Yoshitaro MAKISE.
By this parser, you can apply gtags(1) to wide variety of programming
languages supported by Pygments. The method of plug-in is very simple.
See 'plugin-factory/PLUGIN_HOWTO.pygments' for details.
It should mention especially that Pygments plug-in parser can treat both
definitions and references using Exuberant Ctags together.
Version 6.3.1 - August 11 2014
[CHANGES]
New facilities:
o gtags.vim: New 'Gtagsa' (Gtags with append) command.
This command appends tags to the current tag list.
If you want to get a union of 'global -d foo' and
'global -r foo' then please do as follows:
:Gtags -d foo
:Gtagsa -r foo
o geco.rc: New command (Bash function).
You need bash, percol and less to use geco.
$ source /usr/local/share/gtags/geco.rc
$ geco --help # show help
$ geco mai[TAB] # auto completion
v
$ geco main [ENTER]
QUERY> init # narrowing down
(less's screen)
:tag -r main # tag jump again
The same options are available on the both prompts:
$ geco <options> arg
:tag <options> arg
[INCOMPATIBLE CHANGES]
o global: The following configuration variables were removed
since they will surely cause confusion:
GTAGSROOT, GTAGSDBPATH
These variables were added in Version 6.3.
Version 6.3 - June 9 2014
[CHANGES]
New facilities:
o htags-server: A private HTTP/CGI web server for a hyper-text
generated by htags(1).
o gtags.conf: New project based configuration mechanism.
You can make a configuration file for each project.
This is Leo Liu's idea.
o gtags, htags: New environment variables which have default
options for each command: GTAGS_OPTIONS, HTAGS_OPTIONS
o global: Added support of GREP_COLORS environment variable.
o global: Added new options:
-F (--first-match), -M (--match-case), -E (--extended-regexp)
[DEPRECATED FEATURES]
The following features of htags(1) are now deprecated.
They will be removed in the future.
o The -c (--compact) option.
o The --system-cgi option.
o The --overwrite-key option.
o The -x (--xhtml[=version]) option.
All files will be 1.0.
o The following configuration variables:
colorize-warned-line (substitute: --colorize-warned-line)
gzipped_suffix
htags_options (substitute: HTAGS_OPTIONS)
ncol (substitute: -n, --line-number [n])
normal_suffix (will be always '.html')
no_order_list (substitute: --no-order-list)
script_alias
tabs (substitute: --tabs n)
xhtml_version (will be always 1.0)
[FIXED BUGS]
o global: Highlight of symbols in library paths does not
work. Now it works.
o htags: Htags with the --suggest option didn't find GTAGS
in obj directories. Now it works.
Version 6.2.12 - March 31 2014
[CHANGES]
New facilities:
o global: New --color option. It use environment variable GREP_COLOR
(default is red) to highlight matching string like grep (1).
(--colour and GREP_COLORS are not supported this time)
Please try the following command line:
$ global --color=always -x main
[FIXED BUGS]
o global: A lack of initialization of data brought unexpected segmentation
violation; it often occurred during execution of htags(1). Now it is fixed.
This bug exists in the following version: 6.2.10, 6.2.11.
Version 6.2.11 - March 12 2014
[CHANGES]
New facilities:
o global: New -S (--scope) <directory> option. This option prints only tags
which exist under <directory>. It is similar to the -l option, but different
from it in that you need not change directory.
o gtags: Now, the skip list allows glob file patterns (*, ?, [...], [!...], [^...]).
o gtags.conf: Added the following glob patterns to the skip list:
*.orig,*.rej,*.bak,*~,#*#,*.swp,*.tmp,*_flymake.*,*_flymake
o gtags: Now, the -I option supports file list (-f option or gtags.files).
Instead, idutils 4.5 or later is required.
[FIXED BUGS]
o global: With combination of the --invert-match and --literal, it did not match
the last line of files. Now it works.
o global: Literal search with the -i option printed an unmatched tag in a certain
kind of case. Now it works.
o global: 'global -cI' without argument caused segmentation fault.
Now it works.
Version 6.2.10 - January 16 2014
[CHANGES]
New facilities:
o gtags.el: New custom variables 'gtags-find-all-text-files'.
Optimization:
o global: Optimization of case-insensitive search like:
$ global -xi strlen
$ global -xi '^str'
[FIXED BUGS]
o global: Combination of the -v and -g option showed wrong matched
number (always 0). Now it works.
o global: The --from-here option did not work with a path name
which includes symbolic links. Now it works.
o global: The -I command failed when logical and physical path name
of the current working directory were not identical.
Now it works.
o htags: Htags couldn't find tag files in obj directories.
Now it works.
o ctags-5.8.patch: This file was not included in old packages.
Now it is included.
Version 6.2.9 - August 26 2013
[CHANGES]
New facilities:
o configure: New option --with-sitekeys-mode=MODE.
Changed:
o jquery.treeview.js: Removed effects on mouse over because they use time too much
to build a tree. Now it works faster than previous versions.
o htags: Added a loading message when the --tree-view option is specified.
[INCOMPATIBLE CHANGES]
o gtags-cscope: Though previous gtags-cscope ignored GTAGSROOT, GTAGSDBPATH when
the -d option was not specified, it was meaningless. Now it accepts both of them
always.
[FIXED BUGS]
o gtags-cscope: Arrow keys didn't work after execution of external programs. Now it works.
o global: The -u option didn't work in a project whose path includes blanks. Now it works.
o htags: Fixed some bugs about --tree-view option.
- The type argument of --tree-view option didn't work in the top page. Now it works.
- Directory icons by --tree-view=filetree were not displayed. Now it works.
- On-line manual didn't say about the type argument. Now it is written.
Version 6.2.8 - February 28 2013
[CHANGES]
New facilities:
o htags: Added support of Python's built-in web server.
Required python 2.4 or later.
Please try this: (CGI and AJAX work completely)
$ htags --suggest2
$ cd HTML
$ python -m CGIHTTPServer # Python 2.X(2.4-)
($ python3 -m http.server --cgi # Python 3.X)
Serving HTTP on 0.0.0.0 port 8000 ...
(in another terminal)
$ firefox http://localhost:8000/
o gtags.conf: Added a new record for Drupal(Content management platform).
o global: New --path-style=<format> option.
<format> may be relative, absolute, shorter, abslib and through.
shorter: use shorter one among relative and absolute paths.
abslib: use absolute path only in library projects.
through: raw path name as is in GPATH.
The --path-style option is given more priority than the -a options.
[INCOMPATIBLE CHANGES]
o htags: End of support of customization of HTML tag using gtags.conf.
Please use CSS(cascading style sheets) instead.
- The --html option of htags(1) was removed.
- The tag definitions in gtags.conf were removed.
Version 6.2.7 - December 22 2012
[FIXED BUGS]
global: The -g command failed in handling of files whose size is 0 in some systems.
Now it works.
Version 6.2.6 - December 11 2012
[CHANGES]
New facilities:
ctags-5.8.patch: Patch against ctags-5.8. This adds new option --gtags and new
function makeSimpleReferenceTag() to ctags. These are for making reference tags
for GLOBAL, and enable you to write a single parser for both GLOBAL and ctags
at once.
exuberant-ctags.so: Added support for ctags --gtags option.
Changed:
gtags.vim: Renamed custom variable 'Dont_Jump_Automatically' to 'Gtags_No_Auto_Jump'.
Now 'Dont_Jump_Automatically' is deprecated.
global: The performance of literal search (-g --literal) has been improved.
A pattern string which consists of alphanumeric characters and/or blank characters
is treated as a literal string automatically. Try 'global -gx --literal string'.
Version 6.2.5 - November 16 2012
[CHANGES]
New facilities:
gtags.el: Now supports XEmacs again.
gtags.vim: New custom variable Dont_Jump_Automatically.
[FIXED BUGS]
gtags: Now the following error does not occur.
'input buffer overflow, can't enlarge buffer because scanner uses REJECT'
gtags.el: 'gtags-parse-file' didn't expand the file name (tilde character => $HOME).
Now it works.
Version 6.2.4 - May 30 2012
[FIXED BUGS]
Gtags with the -f option brings segmentation fault. Now it works.
This bug exists only in GLOBAL-6.2.3.
Version 6.2.3 - May 26 2012
[FIXED BUGS]
o Built-in parser: When attribute specifier appeared immediately after
`struct', `union' or `enum' keyword, GLOBAL could not pick up tag name.
Now it works correctly.
[CHANGES]
New facilities:
o gtags: --single-update option support addition of a file.
o global: New --single-update option.
o gtags.el: New custom variables:
- gtags-ignore-case
- gtags-auto-update.
o gtags.vim: New custom variables 'Gtags_Auto_Update' (default 0).
Version 6.2.2 - March 15 2012
[FIXED BUGS]
o configure: The --disable-gtagscscope option didn't avoid building gtags-cscope
completely. So, ./configure failed when there is no curses library.
Now it avoids building gtags-cscope completely.
o htags: Imported a patch to fix htags on Windows Vista+ (tmpfile wants to create
its file in the root directory, which is not writable by normal users).
Version 6.2.1 - February 24 2012
[CHANGES]
New facilities:
o gtags: New --accept-dotfiles option.
o configure: New --disable-gtagscscope option.
o gtags.el: Key mapping was changed to follow "Key binding conventions" of Emacs Lisp.
- The prefix character "\C-c" for suggested key mapping became customizable.
If you want to invoke 'gtags-find-tag by "\C-xt", please write your .emacs file
like follows:
[$HOME/.emacs]
(setq gtags-suggested-key-mapping t)
(setq gtags-prefix-key "\C-x")
[INCOMPATIBLE CHANGES]
o gtags.el: Key mapping was changed to follow "Key binding conventions" of Emacs Lisp.
- Policy of key mapping was changed.
[Old] If 'gtags-suggested-key-mapping' is false, any key mapping is not done.
[New] If 'gtags-suggested-key-mapping' is false, almost key mapping is not done.
But "\C-m" and "\C-t" in 'Gtags select mode' are always enabled.
[FIXED BUGS]
global: The -L option with '-' didn't work. Now it works.
Built-in parser:
- Pick up symbols in expression in enumerator-list as "reference or other symbol".
- C/C++ parser couldn't handle typedef of the form of 'typedef enum tag_name TYPEDEF_NAME;'
correctly. Now, it works.
Version 6.2 - January 21 2012
[CHANGES]
New facilities:
o gtags.el: Added support for TRAMP. Now gtags.el works almost transparently with TRAMP.
Please send a bug report to the bug mailing list.
o gtags-cscope: Enables an environment variable EDITOR allow options.
o gtags-cscope: New -i option.
o gtags-cscope.vim: New custom variable GtagsCscope_Kepp_Alive.
o globash: Added long name options:
use, show, first, last, next, prev: --vi, --less, --emacs, --vim, --gozilla, --noedit
mark: --list, --edit
cookie: --list, --edit, --menu, --warp
o gtags: Add keywords introduced in ISO/IEC 9899:2011.
_Alignas _Alignof _Atomic _Generic _Noreturn _Static_assert _Thread_local
[INCOMPATIBLE CHANGES]
o less-global: Quoting is required for the pattern which should be interpreted by the shell.
[FIXED BUGS]
The icase_path config variable didn't affect the -c command with the -P option of global.
Now it works.
Version 6.1 - October 7 2011
[CHANGES]
New facility:
o Server side GLOBAL
You can use some shell scripts instead of global, gtags and htags.
By this facility, you need not install GLOBAL in your client machine.
Client machine Network Server machine
+--------------+ +---------------+
|gtags-client |-------- SSH ------>| gtags |-->GTAGS,GRTAGS,GPATH
| | | | |
|global-client |<------- SSH ------>| global |<----+
| | | |
| vi, emacs |<------- NFS ------>| project files |
+--------------+ +---------------+
Please read script/README for the details.
Version 6.0 - September 7 2011
[CHANGES]
New facilities:
o Now GLOBAL allows path names which include blanks.
o Now GLOBAL refuses looping symbolic links.
o global: the -c command accepts -T option.
o global: the -c command locates symbols in the directories in GTAGSLIBPATH.
o global: New --match-part option.
o global: New environment variable GTAGSTHROUGH. If this variable is set,
the -T option is specified.
o global: New output format 'ctags-mod'. It is used in gtags.vim.
o global: New environment variable GTAGSBLANKENCODE.
o htags: Changed the cflow loader to accept "_' and HTML special chars (&XXXX;).
o gtags.vim: Now allows use of the -s and -r option at the same time.
o gtags.vim: Now custom variables: 'Gtags_Auto_Map' (default 0).
o gtags.el: New custom variable 'gtags-grep-all-text-files'.
o gtags-cscope: New -a option.
o gtags-cscope.vim: New custom variables: 'GtagsCscope_Use_Old_Key_Map',
'GtagsCscope_Ignore_Case', 'GtagsCscope_Absolute_Path'.
[INCOMPATIBLE CHANGES]
o gtags.el: Now each gtags-find-xxx command follows 'case-fold-search' variable.
o gtags.el: Mouse key mappings for xemacs is not done any longer.
o gtags.el: Changed the prefix character of the commands from 'ESC' to 'Ctrl-c'
to avoid collisions with the default key mapping. If you want to use the old
key mapping, please write the followings in your '.emacs' file.
(setq gtags-suggested-key-mapping t)
(setq gtags-use-old-key-map t)
o gtags.el: New policy of key mapping:
- If 'gtags-suggested-key-mapping' is false, any key mapping is not done.
- If 'gtags-disable-pushy-mouse-mapping' is true, any mouse mapping is not done.
o gtags-cscope.vim: The default value of 'GtagsCscope_Auto_Map' and
'GtagsCscope_Auto_Load' was changed to 0. Additionally, the default key mapping
was changed to the one derived from 'cscope_maps.vim' that was made
by the cscope team.
If you hope older environment, please write the followings to your '.vimrc' file.
let GtagsCscope_Auto_Load = 1
let GtagsCscope_Auto_Map = 1
let GtagsCscope_Use_Old_Key_Map = 1
o gtags.vim: Changed the -P sub-command not to accept NULL input.
Please input '/' instead.
o gtags-cscope: Title changed.
Find this C symbol: -> Find this symbol
Find functions calling this function: -> Find locations calling this function:
o gtags.conf: The lines which start with a '#' on continuation lines is considered
to be a comment line.
[example]
:langmap=C\:.c:\
# :langmap=C#\:.cs:\
:langmap=Java\:.java:
[old]
considered as:| :langmap=C\:.c:# :langmap=C#\:.cs: :langmap=Java\:.java:|
[new]
considered as:| :langmap=C\:.c: :langmap=Java\:.java:|
[FIXED BUGS]
o gtags.el: gtags-mode-hook and gtags-select-mode-hook were not the last thing run
when entering the mode. It has been fixed.
Version 5.9.7 - July 1 2011
[CHANGES]
New facilities:
o global: the -c command accepts new -P and -r option.
o gozilla: Now support firefox.
o globash: Added two commands: d and rs.
[INCOMPATIBLE CHANGES]
o globash: The -l option in each search command was removed.
o gtags.el: Removed the default mouse key mapping in gtags-mode and gtags-select-mode.
If gtags-suggested-key-mapping is true, the old mouse key mapping is available.
[$HOME/.emacs]
+------------------------------------------------
|(setq gtags-suggested-key-mapping t)
[NEW FACILITIES IN TESTING STAGE]
You can use the following facilities by setting GTAGSTESTING environment variable.
Please try:
$ export GTAGSTESTING= (in sh)
or
% setenv GTAGSTESTING (in csh)
o gtags: Now gtags detects looping symbolic link.(testing stage)
o gtags: Now treat blanks in a path correctly.(testing stage)
If you find a bug, please send a bug report to [email protected]. Thank you.
Version 5.9.6 - June 7 2011