From 1dd7dba9fd7f420f82fe6dec068f8925c87debd3 Mon Sep 17 00:00:00 2001
From: Mark Wooding <mdw@distorted.org.uk>
Date: Wed, 7 Aug 2019 18:26:29 +0100
Subject: [PATCH] doc/*.tex: Add stubs for `file-location' reader methods.

---
 doc/clang.tex | 7 +++++--
 doc/meta.tex  | 8 ++++++++
 doc/misc.tex  | 1 +
 3 files changed, 14 insertions(+), 2 deletions(-)

diff --git a/doc/clang.tex b/doc/clang.tex
index 7c32723..76539c7 100644
--- a/doc/clang.tex
+++ b/doc/clang.tex
@@ -1423,8 +1423,11 @@ Temporary names are represented by objects which implement a simple protocol.
 \begin{describe}{cls}{c-fragment () \&key :location :text}
 \end{describe}
 
-\begin{describe}{gf}{c-fragment-text @<fragment> @> @<string>}
-\end{describe}
+\begin{describe*}
+    {\dhead{gf}{c-fragment-text @<fragment> @> @<string>}
+     \dhead{meth}{c-fragment}
+       {file-location (@<fragment> c-fragment) @> @<floc>}}
+\end{describe*}
 
 \begin{describe}{fun}
     {scan-c-fragment @<scanner> @<end-chars>
diff --git a/doc/meta.tex b/doc/meta.tex
index 0f113b0..dbbf2d6 100644
--- a/doc/meta.tex
+++ b/doc/meta.tex
@@ -39,6 +39,7 @@
 
 \begin{describe*}
     {\dhead{gf}{sod-class-name @<class> @> @<string>}
+     \dhead{meth}{sod-class}{file-location (@<class> sod-class) @> @<floc>}
      \dhead{gf}{sod-class-nickname @<class> @> @<string>}
      \dhead{gf}{sod-class-direct-superclasses @<class> @> @<list>}
      \dhead{gf}{sod-class-chain-link @<class> @> @<class-or-nil>}
@@ -107,6 +108,7 @@
 
 \begin{describe*}
     {\dhead{gf}{sod-slot-name @<slot> @> @<string>}
+     \dhead{meth}{sod-slot}{file-location (@<slot> sod-slot) @> @<floc>}
      \dhead{gf}{sod-slot-class @<slot> @> @<class>}
      \dhead{gf}{sod-slot-type @<slot> @> @<c-type>}}
 \end{describe*}
@@ -147,6 +149,8 @@
 
 \begin{describe*}
     {\dhead{gf}{sod-initializer-slot @<init> @> @<slot>}
+     \dhead{meth}{sod-initializer}
+       {file-location (@<init> sod-initializer) @> @<floc>}
      \dhead{gf}{sod-initializer-value @<init> @> @<fragment>}
      \dhead{gf}{sod-initializer-class @<init> @> @<class>}}
 \end{describe*}
@@ -217,6 +221,8 @@
 
 \begin{describe*}
     {\dhead{gf}{sod-message-name @<message> @> @<string>}
+     \dhead{meth}{sod-message}
+       {file-location (@<message> sod-message) @> @<floc>}
      \dhead{gf}{sod-message-class @<message> @> @<class>}
      \dhead{gf}{sod-message-type @<message> @> @<c-type>}}
 \end{describe*}
@@ -240,6 +246,8 @@
 
 \begin{describe*}
     {\dhead{gf}{sod-method-message @<method> @> @<message>}
+     \dhead{meth}{sod-method}
+       {file-location (@<method> sod-method) @> @<floc>}
      \dhead{gf}{sod-method-class @<method> @> @<class>}
      \dhead{gf}{sod-method-type @<method> @> @<c-type>}
      \dhead{gf}{sod-method-body @<method> @> @<fragment-or-nil>}}
diff --git a/doc/misc.tex b/doc/misc.tex
index 890dd14..51767f6 100644
--- a/doc/misc.tex
+++ b/doc/misc.tex
@@ -1114,6 +1114,7 @@ Most of these symbols are defined in the @|optparse| package.
 
 \begin{describe*}
     {\dhead{fun}{p-name @<property> @> @<name>}
+     \dhead{meth}{property}{file-location (@<property> property) @> @<floc>}
      \dhead{fun}{p-value @<property> @> @<value>}
      \dhead{fun}{p-type @<property> @> @<type>}
      \dhead{fun}{p-key @<property> @> @<symbol>}
-- 
2.11.0