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

Something is wrong with git-stage docs #49

Closed
frioux opened this issue Oct 29, 2013 · 2 comments
Closed

Something is wrong with git-stage docs #49

frioux opened this issue Oct 29, 2013 · 2 comments
Labels

Comments

@frioux
Copy link

frioux commented Oct 29, 2013

Forgive me if this is something on my end, like an old xmlto. When I build git-fc I get this error:

  XMLTO git-stage.1
  xmlto: /home/frew/code/git-fc/Documentation/git-stage.xml does not validate (status 3)
  xmlto: Fix document syntax or use --skip-validation option
  /home/frew/code/git-fc/Documentation/git-stage.xml:27: element refsect1: validity error : Element refsect1 content does not follow the DTD, expecting (refsect1info? , (title , subtitle? , titleabbrev?) , (((calloutlist | glosslist | bibliolist | itemizedlist | orderedlist | segmentedlist | simplelist | variablelist | caution | important | note | tip | warning | literallayout | programlisting | programlistingco | screen | screenco | screenshot | synopsis | cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | constructorsynopsis | destructorsynopsis | methodsynopsis | formalpara | para | simpara | address | blockquote | graphic | graphicco | mediaobject | mediaobjectco | informalequation | informalexample | informalfigure | informaltable | equation | example | figure | table | msgset | procedure | sidebar | qandaset | task | anchor | bridgehead | remark | highlights | abstract | authorblurb | epigraph | indexterm | beginpage)+ , refsect2*) | refsect2+)), got (title )
  Document /home/frew/code/git-fc/Documentation/git-stage.xml does not validate
  make[1]: *** [git-stage.1] Error 13
  make[1]: Leaving directory `/home/frew/code/git-fc/Documentation'
  make: *** [doc] Error 2

I suspect you don't typically do "make doc". If I get a chance I'll try to shoot a patch.

@frioux
Copy link
Author

frioux commented Oct 29, 2013

OK, this is silly, but the issue is that there is no Description. I just applied the following patch and fixed my problem:

  diff --git a/Documentation/git-stage.txt b/Documentation/git-stage.txt
  index 3e52a66..c66a783 100644
  --- a/Documentation/git-stage.txt
  +++ b/Documentation/git-stage.txt
  @@ -20,6 +20,7 @@ SYNOPSIS
   DESCRIPTION
   -----------

  +Foo

   COMMANDS
   --------

@felipec
Copy link
Owner

felipec commented Oct 31, 2013

I see. I've pushed a fix, thanks.

@felipec felipec closed this as completed Oct 31, 2013
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

2 participants