Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

custom tags not handled for some elements #6707

Closed
vicuna opened this issue Dec 12, 2014 · 7 comments
Closed

custom tags not handled for some elements #6707

vicuna opened this issue Dec 12, 2014 · 7 comments

Comments

@vicuna
Copy link

vicuna commented Dec 12, 2014

Original bug ID: 6707
Reporter: @kenichi-asai
Assigned to: @zoggy
Status: confirmed (set by @gasche on 2014-12-12T14:50:47Z)
Resolution: open
Priority: normal
Severity: feature
Platform: Apple
OS: MacOS X
OS Version: 10.8
Version: 4.01.0
Category: ocamldoc
Monitored by: @gasche @hcarty

Bug description

It appears that custom tags are not handled in:

Steps to reproduce

Attached file contains an example where documents are written both in English (after @en tag) and in Japanese (after @ja tag). By passing "-lang en" or "-lang ja" argument to ocamldoc, I want to select the corresponding documents. However, the documents in the html-* directories obtained by executing "make" are not as expected.

  • the first text "module header in *" is ignored, but it should appear in index.html. (If I remove "@en", the text appears there.)
  • the two "Session header" texts are ignored, but they should appear in Test.html.
  • the texts for "A" and "B" are ignored, but they should appear in Test.html.

File attachments

@vicuna
Copy link
Author

vicuna commented Dec 12, 2014

Comment author: @gasche

I reproduced the issue -- I also tried to see how to fix it, but I don't understand ocamldoc's internals well enough for that. It would be interesting to have a workaround of the form "just overload this other method and you'll be able to override this default behavior".

@github-actions
Copy link

This issue has been open one year with no activity. Consequently, it is being marked with the "stale" label. What this means is that the issue will be automatically closed in 30 days unless more comments are added or the "stale" label is removed. Comments that provide new information on the issue are especially welcome: is it still reproducible? did it appear in other contexts? how critical is it? etc.

@github-actions github-actions bot added the Stale label May 11, 2020
@kenichi-asai
Copy link

I tested the situation in 4.11.0+alpha1.

  • the first text "module header in *" is ignored, but it should appear in index.html. (If I remove "@en", the text appears there.)

It appears this case is properly handled now. I did not see the problem arises any more.

  • the two "Session header" texts are ignored, but they should appear in Test.html.
  • the texts for "A" and "B" are ignored, but they should appear in Test.html.

The problem persists in these two. In both cases, if I remove "@en", the text appears there.

@stedolan stedolan removed the Stale label May 12, 2020
@github-actions
Copy link

github-actions bot commented Jun 7, 2021

This issue has been open one year with no activity. Consequently, it is being marked with the "stale" label. What this means is that the issue will be automatically closed in 30 days unless more comments are added or the "stale" label is removed. Comments that provide new information on the issue are especially welcome: is it still reproducible? did it appear in other contexts? how critical is it? etc.

@github-actions github-actions bot added the Stale label Jun 7, 2021
@kenichi-asai
Copy link

I tested the situation in 4.12.0. I reported last year that the first problem went away in 4.11.0+alpha1, but I was wrong. All the three problems persist in 4.12.0.

@github-actions github-actions bot removed the Stale label Jun 9, 2021
@Octachron
Copy link
Member

Note that the feature is unlikely to be ever implemented in ocamldoc. Ocamldoc is in maintenance mode and further development efforts are focused on odoc.

@github-actions
Copy link

This issue has been open one year with no activity. Consequently, it is being marked with the "stale" label. What this means is that the issue will be automatically closed in 30 days unless more comments are added or the "stale" label is removed. Comments that provide new information on the issue are especially welcome: is it still reproducible? did it appear in other contexts? how critical is it? etc.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

4 participants