# PR#6597: manual, forward references to languages extensions #1030

Merged
merged 10 commits into from Feb 5, 2017

## Conversation

Projects
None yet
2 participants
Contributor

### Octachron commented Feb 4, 2017

 PR#6597 This PR adds some forward references to language extensions inside the main language reference section, with the aim to decrease −at least a little− the fragmentation of the description of the grammar of current OCaml. More precisely, after each description of non-terminal symbols, this PR references all language extensions that extends these symbols. These references are added as plain text rather than footnotes to give them some amount of visibility.
Member

### gasche commented Feb 4, 2017

 How are the \ref{..} rendered? Because if the result is just "See also 5.14, 6.17 and 8.3", then I don't see how people would ever click on those. I would need to at least have a human-readable description of the content of the pointed section to discover them (for example, if I'm looking for a syntactic construction in the manual and I don't find it in the main section, maybe the name of the extensions lets me focus on a few that might be responsible for this construction, and rule out the unrelated ones).
Contributor

### Octachron commented Feb 4, 2017

 A fine point. Indeed, the reference were rendered as 7.21 etc… I have converted to hyperref using the section name as a short description.

### gasche reviewed Feb 4, 2017

Changes
 @@ -94,6 +94,10 @@ Next version (4.05.0): ### Manual and documentation: - PR#6597: add forward references to language extensions that

#### gasche Feb 4, 2017

Member

You should also include GPR#1030. Otherwise the PR seems good to go.

### Octachron added some commits Feb 4, 2017

 Forward references to constant extensions 
 2efa86e 
 Forward reference to pattern extensions 
 94c0a5b 
 Forward references to expr extension 
 0f40f18 
 Forward references to classes extension 
 1242bca 
 Forward references to module type extensions 
 f680d31 
 Forward references to module extensions 
 fc6257d 
 Forward reference to lex extension 
 1874317 
 Forward references to type declaration extension 
 8bfda24 
 Forward references to type expression extension 
 2af1943 
 Changes for PR#6597/GPR#1030 
 b417c2b 

### gasche merged commit 40a9130 into ocaml:trunk Feb 5, 2017 2 checks passed

#### 2 checks passed

continuous-integration/appveyor/pr AppVeyor build succeeded
Details
continuous-integration/travis-ci/pr The Travis CI build passed
Details

### camlspotter pushed a commit to camlspotter/ocaml that referenced this pull request Oct 17, 2017

 Merge pull request #1030 from Octachron/ocaml-manual-forward-refs 
PR#6597:  manual, forward references to languages extensions
 0292174