ABAP Development: ABAP News for Release

7.50 - ABAP Keyword Documentation

Posted by Horst Keller 25 Nov, 2015
Although ABAP and ABAP CDS are rather self-explaining some of you still tend to use F1 on ABAP or ABAP
CDS keywords in the ABAP Workbench and/or ADT. Then, wondrously, the ABAP Keyword Documentation
appears, and if you're lucky, you directly find what you searched for (of course that kind of context sensitive
help is overrated; in HANA Studio, you boldly program without such fancies). But since it still seems to be used,
one or the other improvement is also done for the ABAP Keyword Documentation. (B.t.w.: What are the most
commonly looked up ABAP statements? - SELECT, READ TABLE, DELETE itab).

Full Text Search in ADT

In the SAP GUI version of the ABAP Keyword Documentation you can carry out an explicit full text search
since long. When calling the documentation by transaction ABAPHELP or from SE38 you find the respective
radio button:

From the documentation display you can also explicitly call the full text seach by selecting Extended Search:

Generated by Jive on 2016-05-25+02:00

1

ABAP Development: ABAP News for Release 7.50 - ABAP Keyword Documentation

Not so in ADT (Eclipse). In ADT the so called Web Version of the ABAP Keyword Documentation is used.
That's not the one you find in the portal but one that can be reached by an ICF service maintained in
transaction SICF and that you can also call with program ABAP_DOCU_WEB_VERSION (of course the
contents of all versions are the same, only the display and the functionality of the displays differ, with the
functionality of the ADT version coming closer and closer to the SAP GUI version).
Up to now, the Web Version used in ADT started with an index search and only switched to full text search if
nothing was found. With ABAP 7.50 you can call the full text search in the Web Version and in ADT explicitly.
Simply put double quotes around your search term:

So simple. Furthermore, you can continue searching in the hit list of an index search:

Generated by Jive on 2016-05-25+02:00

2

ABAP Development: ABAP News for Release 7.50 - ABAP Keyword Documentation

A piece of cake! Wonder why I had waited so long to implement it. The next one was harder.

Special Characters in Syntax Diagrams

In good old times, the special characters { }, [ ], | had no special meaning in ABAP. Therefore, they were used
with special meanings in the syntax diagrams of the ABAP Keyword Documentation, denoting logical groups,
optional additions and alternatives. This has changed since string templates. Mesh paths and of course the
DDL of ABAP CDS are other examples.
This resulted in syntax diagrams, where you couldn't decide which special characters are part ot the syntax
and which are markups, e.g. embedded expressions:

After some complaints from colleagues (customers never complain, almost). I changed that and use another
format for markup characters from ABAP 750 on. Embedded expressions now:

Generated by Jive on 2016-05-25+02:00

3

ABAP Development: ABAP News for Release 7.50 - ABAP Keyword Documentation

A small step for mankind, but a large step for me. Why that? I had to check and adjust about eighteen
thousand { }, [ ], | characters manually arrrgh! Couldn't figure out a way of replacing them with a program. The
results are worth a look.
Maybe it takes a little getting used to, but my colleagues didn't complain any more. Time for customers to
complain? Any suggestions regarding the format? Now I have only a few lines of code to change in order to
adjust the format of all markup characters in one go ...

1944 Views Tags: abap

Sandra Rossi in response to Horst Keller on page 4

21 Mar, 2016 7:01 PM
It was more a hope than a real request
I understand "easily that it's complex" (the ABAP grammar must be
one of the most complex in all languages I know); it's interesting to know that you tried to do it several years
ago. I wish you a lot of courage for all these future additions !
Horst Keller in response to Sandra Rossi on page 4
21 Mar, 2016 10:44 AM
Sandra, if I understand you right, you propose that the keyword documentations syntax diagrams are
generated from compiler resources and the info developer only adds the documentation?
Yes, Id like to have that too, but its not so easily possible, especially, if one wants to split the documentation
into senseful sections.
Some years ago we gave it a try with the generated syntax diagrams that you find by selecting the icon close
to the headings of keyword chapters of the documentation in SAP GUI. The basics of those come from the
compiler team. Unfortunately they are not supported any longer and are getting out of date. I switch them off
one by one in the moment a statement gets new additions.
Sandra Rossi
19 Mar, 2016 5:20 PM
Horst, I'd like to complain that the public grammar should be set up by the SAP "compiler" team (the grammar
that the compiler really uses), with also a public class to nicely parse the code better than the existing (AFAIK)
lexers ;-)

Generated by Jive on 2016-05-25+02:00

4