After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 681641 - Port to new documentation infrastructure
Port to new documentation infrastructure
Status: RESOLVED FIXED
Product: evolution
Classification: Applications
Component: User Documentation
3.6.x (obsolete)
Other All
: Normal normal
: ---
Assigned To: evolution-user-docs
Evolution QA team
Depends on:
Blocks: 681609
 
 
Reported: 2012-08-11 09:02 UTC by Javier Jardón (IRC: jjardon)
Modified: 2013-09-13 01:07 UTC
See Also:
GNOME target: ---
GNOME version: ---


Attachments
Use-new-documentation-infrastructure (9.30 KB, patch)
2012-08-11 09:02 UTC, Javier Jardón (IRC: jjardon)
committed Details | Review

Description Javier Jardón (IRC: jjardon) 2012-08-11 09:02:53 UTC
Created attachment 220920 [details] [review]
Use-new-documentation-infrastructure

Use yelp-tools instead of gnome-doc-utils.

https://live.gnome.org/GnomeGoals/NewDocumentationInfrastructure
Comment 1 Matthew Barnes 2012-08-11 15:16:50 UTC
Nice, thanks for that!

Looks pretty straight-forward and yelp-tools is already in GNOME 3.4.

Committed for Evolution 3.5.90 in:
http://git.gnome.org/browse/evolution/commit/?id=67135c3fb618962c15a5e3252b797686a30e3a52
Comment 2 Milan Crha 2012-08-13 06:30:10 UTC
(In reply to comment #1)
> Looks pretty straight-forward and yelp-tools is already in GNOME 3.4.

Not on my machine, there should be added some checking, otherwise you'll end like this:
    * Configuring... (evolution)
     yelp.m4 not found
   ***Error***: some autoconf macros required to build Evolution
     were not found in your aclocal path, or some forbidden
     macros were found.  Perhaps you need to adjust your
     ACLOCAL_FLAGS?
Comment 3 Milan Crha 2012-08-13 06:52:40 UTC
And after I installed yelp-tools, I got also:
   configure: error: itstool not found
Comment 4 Fabien Tassin 2012-08-13 10:21:22 UTC
@mcrha: fyi, in debian/ubuntu, itstool is a dependency of yelp-tools.

$ apt-cache show yelp-tools | grep Depends
Depends: xsltproc, libxml2-utils, itstool


But I agree with #c2, a test for yelp.m4 is welcome.
Without it, I ended up with a build failure saying 'missing separator' in help/Makefile, and it was the unsubstituted YELP m4 macro. It should have aborted much earlier in configure.
Comment 5 Matthew Barnes 2012-08-13 10:58:24 UTC
configure.ac already has the YELP_HELP_INIT macro, which is as much checking as we ever had for gnome-doc-utils.  Don't know what else to add.

I think yelp-tools just needs more time to become as universal as gnome-doc-utils once was.