| Anonymous | Login | Signup for a new account | 2013-05-21 13:54 CEST |  |
| Main | My View | View Issues | Change Log | Roadmap |
| View Issue Details [ Jump to Notes ] | [ Issue History ] [ Print ] | ||||||||||
| ID | Project | Category | View Status | Date Submitted | Last Update | ||||||
| 0005712 | OCaml | OCaml documentation | public | 2012-08-02 11:35 | 2013-01-03 16:23 | ||||||
| Reporter | Hendrik Tews | ||||||||||
| Assigned To | |||||||||||
| Priority | normal | Severity | text | Reproducibility | always | ||||||
| Status | confirmed | Resolution | open | ||||||||
| Platform | OS | OS Version | |||||||||
| Product Version | 4.00.0 | ||||||||||
| Target Version | 4.00.2+dev | Fixed in Version | |||||||||
| Summary | 0005712: some documentation problems | ||||||||||
| Description | This is the usual bug report about problems that I found while preparing the enhanced OCaml documentation. The list is shorter than for previous versions. Congratulations! 1- ``??'' is not accepted as prefix-symbol, although it is permitted by the grammar 2- the meta symbol ``label-name'' is defined twice, in 6.3 and 6.1 3- ``#load_rec "camlp4o.cma";;'' fails in the usual way, although the documentation says it should load dynlink recursively. 4- the default set of enabled warnings for ocamlopt has changed, the documentation still contains the old one 5- ``Format.printf "@%" does not print a ``%'' as documented 6- OCAMLRUNPARAM flag R is not documented 7- String.{iteri,map} are missing in the documentation of StdLabels (in file /libref/StdLabels.String.html) 8- ArrayLabels, ListLabels, StringLabels are missing in the txt version of the documentation 9- new option -bin-annot is not documented Bye, Hendrik | ||||||||||
| Tags | No tags attached. | ||||||||||
| Attached Files | |||||||||||
 Relationships |
||||||
|
||||||
 Relationships |
|
Notes |
|
|
(0007899) doligez (manager) 2012-08-06 14:00 |
For (1): this is just like "|" or "let": it's listed in the Keywords section, and cannot be used as an identifier. For (2): the two definitions are equivalent. I have removed the one in 6.3 and put a pointer to 6.1. For (3): looks like a bug in the code rather than the documentation. I've filed a separate bug report. For (4): wrong for both ocamlc and ocamlopt, but in different ways. Fixed. (r 12822) For (5): it does, but you have to cheat the type system in order to give "@%" as argument to Format.printf... I've removed that from the doc. (r 12821 and r 12824) For (6): I can't find it in the code either. What is it supposed to do? For (7): the functions are actually missing in the module itself. Fixed. (r 12823 and r 12824) For (8): they are not in the PDF either. I think this is on purpose. For (9): it's not in the man pages and it's not in the reference manual. TO DO |
|
(0007903) Hendrik Tews (reporter) 2012-08-06 17:04 |
6- R is supposed to randomize hash tables, see docs for Hashtbl. 8- But these modules are in the html version! Therefore I would say they should also appear in the pdf and in the txt version. |
|
(0008681) doligez (manager) 2013-01-03 16:23 edited on: 2013-01-03 16:24 |
(6): done in trunk (commits 13197 and 13198) Still to do: (9) and maybe (8) |
|
Notes |
|
Issue History |
|||
| Date Modified | Username | Field | Change |
| 2012-08-02 11:35 | Hendrik Tews | New Issue | |
| 2012-08-06 11:35 | doligez | Relationship added | parent of 0005720 |
| 2012-08-06 14:00 | doligez | Note Added: 0007899 | |
| 2012-08-06 14:00 | doligez | Severity | minor => text |
| 2012-08-06 14:00 | doligez | Status | new => confirmed |
| 2012-08-06 17:04 | Hendrik Tews | Note Added: 0007903 | |
| 2012-09-06 16:44 | doligez | Target Version | => 4.00.1+dev |
| 2012-09-21 15:04 | doligez | Target Version | 4.00.1+dev => 4.00.2+dev |
| 2013-01-03 16:23 | doligez | Note Added: 0008681 | |
| 2013-01-03 16:24 | doligez | Note Edited: 0008681 | View Revisions |
|
Issue History |
| Copyright © 2000 - 2011 MantisBT Group |
 |