2016 Update
This commit is contained in:
parent
948b86eafa
commit
dcf5d15da3
7965 changed files with 139854 additions and 31002 deletions
|
|
@ -1,4 +1,7 @@
|
|||
Show how to insert documentation for classes, functions, and/or variables in your language. If this documentation is built-in to the language, note it. If this documentation requires external tools, note them.
|
||||
|
||||
'''See Also:'''<br>
|
||||
* Related Task: [[Comments]]
|
||||
|
||||
;See also:
|
||||
* Related task: [[Comments]]
|
||||
* Related task: [[Here_document]]
|
||||
<br><br>
|
||||
|
|
|
|||
57
Task/Documentation/COBOL/documentation-1.cobol
Normal file
57
Task/Documentation/COBOL/documentation-1.cobol
Normal file
|
|
@ -0,0 +1,57 @@
|
|||
*>****L* cobweb/cobweb-gtk [0.2]
|
||||
*> Author:
|
||||
*> Author details
|
||||
*> Colophon:
|
||||
*> Part of the GnuCobol free software project
|
||||
*> Copyright (C) 2014 person
|
||||
*> Date 20130308
|
||||
*> Modified 20141003
|
||||
*> License GNU General Public License, GPL, 3.0 or greater
|
||||
*> Documentation licensed GNU FDL, version 2.1 or greater
|
||||
*> HTML Documentation thanks to ROBODoc --cobol
|
||||
*> Purpose:
|
||||
*> GnuCobol functional bindings to GTK+
|
||||
*> Main module includes paperwork output and self test
|
||||
*> Synopsis:
|
||||
*> |dotfile cobweb-gtk.dot
|
||||
*> |html <br />
|
||||
*> Functions include
|
||||
*> |exec cobcrun cobweb-gtk >cobweb-gtk.repository
|
||||
*> |html <pre>
|
||||
*> |copy cobweb-gtk.repository
|
||||
*> |html </pre>
|
||||
*> |exec rm cobweb-gtk.repository
|
||||
*> Tectonics:
|
||||
*> cobc -v -b -g -debug cobweb-gtk.cob voidcall_gtk.c
|
||||
*> `pkg-config --libs gtk+-3.0` -lvte2_90 -lyelp
|
||||
*> robodoc --cobol --src ./ --doc cobwebgtk --multidoc --rc robocob.rc --css cobodoc.css
|
||||
*> cobc -E -Ddocpass cobweb-gtk.cob
|
||||
*> make singlehtml # once Sphinx set up to read cobweb-gtk.i
|
||||
*> Example:
|
||||
*> COPY cobweb-gtk-preamble.
|
||||
*> procedure division.
|
||||
*> move TOP-LEVEL to window-type
|
||||
*> move 640 to width-hint
|
||||
*> move 480 to height-hint
|
||||
*> move new-window("window title", window-type,
|
||||
*> width-hint, height-hint)
|
||||
*> to gtk-window-data
|
||||
*> move gtk-go(gtk-window) to extraneous
|
||||
*> goback.
|
||||
*> Notes:
|
||||
*> The interface signatures changed between 0.1 and 0.2
|
||||
*> Screenshot:
|
||||
*> image:cobweb-gtk1.png
|
||||
*> Source:
|
||||
REPLACE ==FIELDSIZE== BY ==80==
|
||||
==AREASIZE== BY ==32768==
|
||||
==FILESIZE== BY ==65536==.
|
||||
|
||||
id identification division.
|
||||
program-id. cobweb-gtk.
|
||||
|
||||
...
|
||||
|
||||
done goback.
|
||||
end program cobweb-gtk.
|
||||
*>****
|
||||
16
Task/Documentation/COBOL/documentation-2.cobol
Normal file
16
Task/Documentation/COBOL/documentation-2.cobol
Normal file
|
|
@ -0,0 +1,16 @@
|
|||
>>IF docpass NOT DEFINED
|
||||
|
||||
... code ...
|
||||
|
||||
>>ELSE
|
||||
!doc-marker!
|
||||
========
|
||||
:SAMPLE:
|
||||
========
|
||||
|
||||
.. contents::
|
||||
|
||||
Introduction
|
||||
------------
|
||||
ReStructuredText or other markup source ...
|
||||
>>END-IF
|
||||
3
Task/Documentation/Fortran/documentation.f
Normal file
3
Task/Documentation/Fortran/documentation.f
Normal file
|
|
@ -0,0 +1,3 @@
|
|||
SUBROUTINE SHOW(A,N) !Prints details to I/O unit LINPR.
|
||||
REAL*8 A !Distance to the next node.
|
||||
INTEGER N !Number of the current node.
|
||||
3
Task/Documentation/MATLAB/documentation.m
Normal file
3
Task/Documentation/MATLAB/documentation.m
Normal file
|
|
@ -0,0 +1,3 @@
|
|||
function Gnash(GnashFile); %Convert to a "function". Data is placed in the "global" area.
|
||||
% My first MatLab attempt, to swallow data as produced by Gnash's DUMP
|
||||
%command in a comma-separated format. Such files start with a line
|
||||
1
Task/Documentation/PowerShell/documentation.psh
Normal file
1
Task/Documentation/PowerShell/documentation.psh
Normal file
|
|
@ -0,0 +1 @@
|
|||
help about_comment_based_help
|
||||
|
|
@ -1,36 +1,29 @@
|
|||
/*REXX program to show how to display embedded documention in REXX code.*/
|
||||
parse arg doc
|
||||
doc=space(doc)
|
||||
if doc=='?' then call help /*show doc if arg is a single ? */
|
||||
/*════════════════════════regular═══════════════════════════════════════*/
|
||||
/*════════════════════════════════mainline══════════════════════════════*/
|
||||
/*═════════════════════════════════════════code═════════════════════════*/
|
||||
/*══════════════════════════════════════════════here.═══════════════════*/
|
||||
exit
|
||||
|
||||
/*──────────────────────────────────HELP subroutine─────────────────────*/
|
||||
help: help=0; do j=1 for sourceline()
|
||||
_=sourceline(j)
|
||||
if _=='<help>' then do; help=1; iterate; end
|
||||
if _=='</help>' then exit
|
||||
if help then say _
|
||||
end /*j*/
|
||||
exit /*stick a fork in it, we're done.*/
|
||||
|
||||
/*──────────────────────────────────start of the in─line documentation.
|
||||
/*REXX program illustrates how to display embedded documentation (help) within REXX code*/
|
||||
parse arg doc /*obtain (all) the arguments from C.L. */
|
||||
if doc='?' then call help /*show documentation if arg=a single ? */
|
||||
/*■■■■■■■■■regular■■■■■■■■■■■■■■■■■■■■■■■■■*/
|
||||
/*■■■■■■■■■■■■■■■■■mainline■■■■■■■■■■■■■■■■*/
|
||||
/*■■■■■■■■■■■■■■■■■■■■■■■■■■code■■■■■■■■■■■*/
|
||||
/*■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■here.■■■■■*/
|
||||
exit /*stick a fork in it, we're all done. */
|
||||
/*──────────────────────────────────────────────────────────────────────────────────────*/
|
||||
help: ?=0; do j=1 for sourceline(); _=sourceline(j) /*get a line of source.*/
|
||||
if _='<help>' then do; ?=1; iterate; end /*search for <help> */
|
||||
if _='</help>' then leave /* " " </help> */
|
||||
if ? then say _
|
||||
end /*j*/
|
||||
exit /*stick a fork in it, we're all done. */
|
||||
/*══════════════════════════════════start of the in═line documentation AFTER the <help>
|
||||
<help>
|
||||
To use the YYYY program, enter:
|
||||
To use the YYYY program, enter one of:
|
||||
|
||||
YYYY numberOfItems
|
||||
YYYY (no arguments uses the default)
|
||||
YYYY ? (to see this documentation)
|
||||
|
||||
|
||||
YYYY numberOfItems
|
||||
YYYY (with no args for the default)
|
||||
YYYY ? (to see this documentation)
|
||||
─── where: numberOfItems is the number of items to be used.
|
||||
|
||||
|
||||
─── where:
|
||||
|
||||
numberOfItems is the number of items to be processed.
|
||||
|
||||
If no "numberOfItems" are entered, the default of 100 is used.
|
||||
If no "numberOfItems" are entered, the default of 100 is used.
|
||||
</help>
|
||||
────────────────────────────────────end of the in─line documentation. */
|
||||
════════════════════════════════════end of the in═line documentation BEFORE the </help> */
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue