Displaying 5 results from an estimated 5 matches for "need_doc".
2015 Feb 12
4
[PATCH 1/3] gobject: generate deprecation markers
Generate proper deprecation markers for API documentation and
introspection annotations.
---
generator/gobject.ml | 8 +++++++-
1 file changed, 7 insertions(+), 1 deletion(-)
diff --git a/generator/gobject.ml b/generator/gobject.ml
index 5b07edd..e563610 100644
--- a/generator/gobject.ml
+++ b/generator/gobject.ml
@@ -961,7 +961,8 @@ guestfs_session_close (GuestfsSession *session, GError **err)
2015 Feb 12
0
[PATCH 3/3] ocaml: hide internal methods from apidocs
...ml b/generator/ocaml.ml
index f8707ae..9284005 100644
--- a/generator/ocaml.ml
+++ b/generator/ocaml.ml
@@ -144,9 +144,14 @@ end
fun ({ name = name; style = style; deprecated_by = deprecated_by;
non_c_aliases = non_c_aliases;
shortdesc = shortdesc } as f) ->
+ let need_doc = is_documented f in
+
+ if not need_doc then
+ pr "(**/**)\n";
+
generate_ocaml_prototype name style;
- if is_documented f then (
+ if need_doc then (
pr "(** %s" shortdesc;
(match deprecated_by with
| None -> ()
@@...
2015 Sep 30
0
[PATCH 2/2] ocaml: Improve ocamldoc.
..._tags then
+ pr "\n";
+ pr "%s *)\n" indent;
+ )
+ in
+
(* The actions. *)
List.iter (
- fun ({ name = name; style = style; deprecated_by = deprecated_by;
- non_c_aliases = non_c_aliases;
- shortdesc = shortdesc } as f) ->
- let need_doc = is_documented f in
-
- if not need_doc then
- pr "(**/**)\n";
-
+ fun ({ name = name; style = style; non_c_aliases = non_c_aliases } as f) ->
generate_ocaml_prototype name style;
-
- if need_doc then (
- let has_tags = ref false in
-
- pr &quo...
2015 Sep 30
3
[PATCH 1/2] ocaml: Use ocamlfind to run ocamldoc.
Using 'ocamlfind ocamldoc' is much faster than running 'ocamldoc'
directly, because ocamlfind will run the native code program
'ocamldoc.opt' if it is available.
This change approximately halves the time taken to compile the ocaml
bindings.
---
ocaml/Makefile.am | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/ocaml/Makefile.am b/ocaml/Makefile.am
index
2015 May 28
4
[PATCH 1/4] generator: move api_version to a common version_added
This way the version string of each API can be used also in other
generator modules.
Mostly code motion, no actual behaviour changes.
---
generator/c.ml | 21 ++++++++++-----------
generator/docstrings.ml | 6 ++++++
2 files changed, 16 insertions(+), 11 deletions(-)
diff --git a/generator/c.ml b/generator/c.ml
index 63dc09a..a2b9c94 100644
--- a/generator/c.ml
+++ b/generator/c.ml
@@