(**export comment**)

Neither formally rejected nor actively developed

(**export comment**)

Postby DGDanforth » Tue Jun 02, 2015 1:10 am

In Docu/BB-Rules.odc I find
5 Comments

Comments which are part of an interface description (rather than a mere implementation description) have additional asterisks, a kind of "export mark" for comments, e.g. (** guard for xyz command **)


and yet such comments are not written to the client interface (CTRL-D)
(at least not for me). Is there some flag that can be set to force this to happen?

-Doug
User avatar
DGDanforth
 
Posts: 1060
Joined: Tue Sep 17, 2013 1:16 am
Location: Palo Alto, California, USA

Re: (**export comment**)

Postby Josef Templ » Tue Jun 02, 2015 3:24 pm

I am not aware of any tool that makes use of this form of comments.
It is well possible that ominc envisioned a tool like JavaDoc that creates
a documentation file out of the commented source code, but I think
that does not exist or may be it existed inside ominc but has not been disclosed.

- Josef
User avatar
Josef Templ
 
Posts: 1947
Joined: Tue Sep 17, 2013 6:50 am

Re: (**export comment**)

Postby DGDanforth » Wed Jun 03, 2015 11:29 am

Josef Templ wrote:I am not aware of any tool that makes use of this form of comments.
It is well possible that ominc envisioned a tool like JavaDoc that creates
a documentation file out of the commented source code, but I think
that does not exist or may be it existed inside ominc but has not been disclosed.

- Josef

Probably true, however, I see many files with the (**...**) construct. Why do this if it has no functionality?
User avatar
DGDanforth
 
Posts: 1060
Joined: Tue Sep 17, 2013 1:16 am
Location: Palo Alto, California, USA

Re: (**export comment**)

Postby Josef Templ » Wed Jun 03, 2015 9:03 pm

I will be away from the Internet for a couple of days...
User avatar
Josef Templ
 
Posts: 1947
Joined: Tue Sep 17, 2013 6:50 am

Re: (**export comment**)

Postby Ivan Denisov » Sun Dec 25, 2016 6:20 am

I think, that we can develop this feature for 1.7.1.

We already adopt an issue about hidden Hooks.

This issue can continue this line.
Ivan Denisov
 
Posts: 1690
Joined: Tue Sep 17, 2013 12:21 am
Location: Russia

(** comment **)

Postby DGDanforth » Sat Oct 21, 2017 5:16 am

Sorry, I know this was discussed. I just don't know where.
(How can I search the whole Board index?)

I have an extensive module called MyVectors for which it would be very useful
to see the (** comments **) exported for each procedure in the sym file.
As it is now I must go back and open the source code to see them.

As I remember Josef hypothesized that Oberon Microsystems intended to add
such a feature but never got around to it.

I would like to see the exported comments generated when a module is compiled
(and not by some other add-on utility). That would mean knowing how a sym file
is generated and getting into the guts of that process.

Anyone willing to tackle that?

-Doug
User avatar
DGDanforth
 
Posts: 1060
Joined: Tue Sep 17, 2013 1:16 am
Location: Palo Alto, California, USA

Re: (** comment **)

Postby Robert » Sat Oct 21, 2017 9:52 am

DGDanforth wrote:Sorry, I know this was discussed. I just don't know where.

It is in ->Features->Deferred.
User avatar
Robert
 
Posts: 961
Joined: Sat Sep 28, 2013 11:04 am
Location: Edinburgh, Scotland

Re: (**export comment**)

Postby DGDanforth » Sat Oct 21, 2017 10:08 am

Robert, thank you for the pointer to here (was that from memory or do you have a search algorithm?)

The addition I would like to add is the export happens at compile time
(the .osf is modified)

-Doug
User avatar
DGDanforth
 
Posts: 1060
Joined: Tue Sep 17, 2013 1:16 am
Location: Palo Alto, California, USA

Re: (**export comment**)

Postby Robert » Sun Oct 22, 2017 8:49 am

DGDanforth wrote:Robert, thank you for the pointer to here (was that from memory or do you have a search algorithm?)

Both!
I have a vague memory of seeing this recently - I probably moved it to the deferred category as part of a recent clean-up of this site.
I tried an "Advanced search" for "(**", but that did not work as "*" is treated as a wildcard and I don't know if there is an escape character.
I then did a (quick) manual search - it did not take long.
User avatar
Robert
 
Posts: 961
Joined: Sat Sep 28, 2013 11:04 am
Location: Edinburgh, Scotland

Re: (**export comment**)

Postby Josef Templ » Sun Oct 22, 2017 7:35 pm

You can type any text (like "export comment") in the search box and you will get results as expected.
The problem with the search box is with special characters like (**.
It is also not possible to search for an issue by a string of the form "issue-#106".
The # is dropped and the rest ("issue-106") is not found.
Searching for "issue 106" finds something close to the intended search.

There may be tricks but there are certainly limits. phpBB searches only for words in the index. So it depends
on the index if a term is found or not. Some words or special chars seem not to be indexed.
Maybe somebody has read the docu more carefully and finds a solution.

- Josef
User avatar
Josef Templ
 
Posts: 1947
Joined: Tue Sep 17, 2013 6:50 am


Return to Deferred (Features)

Who is online

Users browsing this forum: No registered users and 1 guest

cron