Fix a few documentation issues

Review Request #824 — Created July 22, 2021 and submitted

Information

libgnt/libgnt
default
0d3ed9e5099f

Reviewers

Fix a few documentation issues

ran ninja libgnt-doc

Description From Last Updated

This may also be fixable by removing _GntNode?

QuLogicQuLogic
rekkanoryo
  1. Ship It!
  2. 
      
QuLogic
  1. 
      
  2. gntwm.h (Diff revision 1)
     
     
     
     
    Show all issues

    This may also be fixable by removing _GntNode?

    1. diff --git a/gntwm.h b/gntwm.h
      --- a/gntwm.h
      +++ b/gntwm.h
      @@ -51,9 +51,7 @@
        *
        * A node in the window management tree.
        */
      -typedef struct _GntNode GntNode;
      -
      -struct _GntNode
      +typedef struct
       {
              GntWidget *me;
      
      @@ -61,7 +59,7 @@ struct _GntNode
              int scroll;
              PANEL *panel;
              GntWS *ws;
      -};
      +} GntNode;
      
       G_BEGIN_DECLS
      

      Gives us the same warning of

      [1/1] Generating libgnt-doc with a custom command
      Building documentation for libgnt
      html/libgnt-gntwm.html:643: warning: no link for: "GntNode" -> (<span class="type">GntNode</span>).
      
    2. Odd, it seemed to have worked for me:

      $ hg di
      diff --git a/gntwm.h b/gntwm.h
      --- a/gntwm.h
      +++ b/gntwm.h
      @@ -51,8 +51,7 @@
        *
        * A node in the window management tree.
        */
      -typedef struct _GntNode
      -{
      +typedef struct {
              GntWidget *me;
      
              WINDOW *window;
      
      $ ninja -C build clean
      ninja: Entering directory `build'
      [2/2] Cleaning
      Cleaning... 28 files.
      
      $ ninja -C build libgnt-doc
      ninja: Entering directory `build'
      [9/28] Compiling C object libgnt.so.1.0.0.p/gntmain.c.o
      ... warning stuff ...
      [28/28] Generating libgnt-doc with a custom command
      Building documentation for libgnt
      html/api-index-full.html:1140: warning: no link for: "gnt-text-format-flag-to-chtype" -> (gnt_text_format_flag_to_chtype).
      html/api-index-full.html:1140: warning: no link for: "libgnt-gnttextviewprivate" -> (gnttextviewprivate).
      html/libgnt-gntwm.html:994: warning: no link for: "WINDOW:CAPS" -> (<span class="type">WINDOW</span>).
      html/libgnt-gntwm.html:1004: warning: no link for: "PANEL:CAPS" -> (<span class="type">PANEL</span>).
      
  3. 
      
grim
QuLogic
  1. Ship It!
  2. 
      
grim
Review request changed
Status:
Completed