(r10) LCS2016_006f < P1076

P1076 Web>VHDL2017>LCS2016_006f (revision 10) (raw view)~~EditAttach~~
---+ Language Change Specification for Environment API

---++ 

| <sticky><b>LCS Number:</b></sticky> | LCS-2016-006f |
| <sticky><b>Version:</b>   </sticky> | 4 |
| <sticky><b>Date:</b>      </sticky> | 18-Mar-2017  |
| <sticky><b>Status:</b>    </sticky> | Voting |
| <sticky><b>Author:</b>    </sticky> | Thomas Preusser<br/>Jim Lewis |
| <sticky><b>Email:</b>     </sticky> | [[Main.ThomasPreusser]]<br/>[[Main.JimLewis]] |
| <sticky><b>Source Doc:</b></sticky> | |
| <sticky><b>Summary:</b>   </sticky> | Expose standard conditional analysis identifiers. |
| <sticky><b>Dependencies:</b>   </sticky> | [[LCS2016_061][LCS_2016_061]] |

---+++ Voting Results: Cast your votes here

Yes:
   1 %USERSIG{MartinZabel - 2017-03-07}% - ver 3
   1 %USERSIG{JimLewis- 18-Mar-2017 }% - ver 4
   1 %USERSIG{PatrickLehmann - 2017-03-14}% - ver 4
   1 %USERSIG{ThomasPreusser - 2017-03-15}% - ver 3
   1 %USERSIG{RobGaddi - 2017-03-19}% ver 4

No:
   1 

Abstain:
   1 

<noautolink>
---++ Revision Notes

Revision 4:  18-Mar-2017
   * Updated per meeting 16-Mar-2017

Revision 3:  Initial 07-Mar-2017  

---++ Style Notes

Changes are shown in %RED%red font%ENDCOLOR%.%BR%
Deletions are %RED%<del>crossed out</del>%ENDCOLOR%.%BR%
Editing or reviewing notes in %GREEN%green font%ENDCOLOR%.%BR%

---++ Reviewing Notes

This is a proposal extending [[TopLCS2016_006e][LCS006e]]. It exposes the standard conditional analysis identifiers directly through their names as deferred constants of package ENV.

---++ Details of Language Change
---+++ 16.5 Standard environment package
---+++ 16.5.1 General

Package ENV contains declarations that provide a VHDL interface to the host environment.
<pre>package ENV is
  procedure STOP (STATUS: INTEGER);
  procedure STOP;
  procedure FINISH (STATUS: INTEGER);
  procedure FINISH;
 
  function RESOLUTION_LIMIT return DELAY_LENGTH;

  %GREEN%[... LCS-2016-011 ...]%ENDCOLOR%
  %GREEN%[... LCS-2016-006c ...]%ENDCOLOR%
  %GREEN%[... LCS-2016-006e ...]%ENDCOLOR%
  %GREEN%[... LCS-2016-006g ...]%ENDCOLOR%


%RED%  impure function VHDL_VERSION return string ;
  function TOOL_TYPE return string ;
  function TOOL_VENDOR return string ;
  function TOOL_NAME return string ;
  function TOOL_EDITION return string ;
  function TOOL_VERSION return string ;%ENDCOLOR%
end package ENV;
</pre>

---+++ 16.5.5 System Environment API %GREEN%[NEW]%ENDCOLOR%

%GREEN%(This paragraph is to follow the ones possibly added by [[TopLCS2016_006e][LCS006e]] and [[TopLCS2016_006g][LCS006g]].)%ENDCOLOR%

%RED%The impure function VHDL_VERSION returns the value of the standard conditional analysis identifier used for the design unit from which it is called. %ENDCOLOR%

%RED%The functions TOOL_TYPE, TOOL_VENDOR, TOOL_NAME, TOOL_EDITION, and TOOL_VERSION return the value of the corresponding
standard conditional analysis identifiers of the same name.%ENDCOLOR%
<sticky>
---++ Comments


The red edits miss a textual description in section 16.5.

Package ENV has no body. It is tool defined.

The paragraph sign is not used in the LRM to reference other sections.

-- %BUBBLESIG{PatrickLehmann - 2017-03-02}%


Agree with Patrick, red text needs a paragraph description.   Blue text needs to be deleted to separate this proposal from others.

-- %BUBBLESIG{JimLewis - 2017-03-05}%


See my comments for LCS 006g.

How does this LCS handle user defined conditional analysis identifiers?

-- %BUBBLESIG{PatrickLehmann - 2017-03-06}%


*PL*: How does this LCS handle user defined conditional analysis identifiers?

It simply does not. It only provides a shorthand for the standard identifiers as requested by Jim (see his comments on LCS 006e). Full access to all conditional analysis identifiers is rather achieved through LCD 006 d, e or g. 

-- %BUBBLESIG{ThomasPreusser - 2017-03-07}%
%COMMENT%</sticky>

</noautolink>
Topic revision: r1 - 2017-04-02 - 15:46:38 - TWikiGuest
P1076