Removed the file format description from cg_annotate.in, because it's in the
Cachegrind docs.
Removed the Cachegrind tech docs, because they're so out of date to be
useless. My PhD dissertation gives a much better description of how
Cachegrind works. (I mentioned this in the Cachegrind user manual.) The
only still-useful part of Cachegrind's tech docs, the output file format
description, I moved into the Cachegrind user manual.
git-svn-id: svn://svn.valgrind.org/valgrind/trunk@6332 a5019735-40e9-0310-863c-91ae7b9d1cf9
diff --git a/cachegrind/cg_annotate.in b/cachegrind/cg_annotate.in
index fe7a27e..811e5a8 100644
--- a/cachegrind/cg_annotate.in
+++ b/cachegrind/cg_annotate.in
@@ -29,47 +29,8 @@
#----------------------------------------------------------------------------
# The file format is simple, basically printing the cost centre for every
-# source line, grouped by files and functions:
-#
-# file ::= desc_line* cmd_line events_line data_line+ summary_line
-# desc_line ::= "desc:" ws? non_nl_string
-# cmd_line ::= "cmd:" ws? cmd
-# events_line ::= "events:" ws? (event ws)+
-# data_line ::= file_line | fn_line | count_line
-# file_line ::= "fl=" filename
-# fn_line ::= "fn=" fn_name
-# count_line ::= line_num ws? (count ws)+
-# summary_line ::= "summary:" ws? (count ws)+
-# count ::= num | "."
-#
-# where
-# 'non_nl_string' is any string not containing a newline.
-# 'cmd' is a string holding the command line of the profiled program.
-# 'filename' and 'fn_name' are strings.
-# 'num' and 'line_num' are decimal integers.
-# 'ws' is whitespace.
-#
-# The contents of the "desc:" lines are printed out at the top
-# of the summary. This is a generic way of providing simulation
-# specific information, eg. for giving the cache configuration for
-# cache simulation.
-#
-# More than one line of info can be presented for each file/fn/line number.
-# In such cases, the counts for the named events will be accumulated.
-#
-# Counts can be "." to represent zero. This makes the files easier to read.
-#
-# The number of counts in each 'line' and the 'summary_line' should not exceed
-# the number of events in the 'event_line'. If the number in each 'line' is
-# less, cg_annotate treats those missing as though they were a "." entry.
-#
-# A 'file_line' changes the current file name. A 'fn_line' changes the
-# current function name. A 'count_line' contains counts that pertain to the
-# current filename/fn_name. A 'file_line' and a 'fn_line' must appear
-# before any 'count_line's to give the context of the first 'count_line'.
-#
-# Each 'file_line' will normally be immediately followed by a 'fn_line'.
-# But it doesn't have to be.
+# source line, grouped by files and functions. The details are in
+# Cachegrind's manual.
#----------------------------------------------------------------------------
# Performance improvements record, using cachegrind.out for cacheprof, doing no