Hello community, here is the log from the commit of package yelp-tools for openSUSE:Factory checked in at 2020-11-19 11:57:36 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Comparing /work/SRC/openSUSE:Factory/yelp-tools (Old) and /work/SRC/openSUSE:Factory/.yelp-tools.new.5913 (New) ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Package is "yelp-tools" Thu Nov 19 11:57:36 2020 rev:29 rq:847275 version:3.38.0 Changes: -------- --- /work/SRC/openSUSE:Factory/yelp-tools/yelp-tools.changes 2019-06-22 11:20:54.681175094 +0200 +++ /work/SRC/openSUSE:Factory/.yelp-tools.new.5913/yelp-tools.changes 2020-11-23 10:54:47.938860836 +0100 @@ -1,0 +2,12 @@ +Mon Sep 14 10:27:10 UTC 2020 - dims...@opensuse.org + +- Update to version 3.38.0: + + Stable release. No changes since 3.37.90. + +------------------------------------------------------------------- +Fri Sep 4 09:38:42 UTC 2020 - dims...@opensuse.org + +- Update to version 3.37.90: + + yelp-new: Added new templates. + +------------------------------------------------------------------- Old: ---- yelp-tools-3.32.2.tar.xz New: ---- yelp-tools-3.38.0.tar.xz ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Other differences: ------------------ ++++++ yelp-tools.spec ++++++ --- /var/tmp/diff_new_pack.xvoJAM/_old 2020-11-23 10:54:48.982861880 +0100 +++ /var/tmp/diff_new_pack.xvoJAM/_new 2020-11-23 10:54:48.986861885 +0100 @@ -1,7 +1,7 @@ # # spec file for package yelp-tools # -# Copyright (c) 2019 SUSE LINUX GmbH, Nuernberg, Germany. +# Copyright (c) 2020 SUSE LLC # # All modifications and additions to the file contributed by third parties # remain the property of their copyright owners, unless otherwise agreed @@ -17,13 +17,13 @@ Name: yelp-tools -Version: 3.32.2 +Version: 3.38.0 Release: 0 Summary: Collection of utilities to help create documentation License: GPL-2.0-or-later Group: Development/Tools/Other URL: https://projects.gnome.org/yelp/ -Source: https://download.gnome.org/sources/yelp-tools/3.32/%{name}-%{version}.tar.xz +Source: https://download.gnome.org/sources/yelp-tools/3.38/%{name}-%{version}.tar.xz BuildRequires: itstool BuildRequires: libxml2-tools BuildRequires: libxslt ++++++ yelp-tools-3.32.2.tar.xz -> yelp-tools-3.38.0.tar.xz ++++++ diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/yelp-tools-3.32.2/ChangeLog new/yelp-tools-3.38.0/ChangeLog --- old/yelp-tools-3.32.2/ChangeLog 2019-06-12 22:18:25.000000000 +0200 +++ new/yelp-tools-3.38.0/ChangeLog 2020-09-12 21:42:30.000000000 +0200 @@ -1,3 +1,84 @@ +commit 79f14302053c9881de371143a61976ee1d27883c +Author: Shaun McCance <sha...@redhat.com> +Date: Sat Aug 8 10:24:27 2020 -0400 + + Version 3.37.90 + + NEWS | 4 ++++ + configure.ac | 2 +- + 2 files changed, 5 insertions(+), 1 deletion(-) + +commit 5bfea4acd826e7e66ae3b979f0402623d7f76330 +Merge: 79067c7 20c1b7e +Author: Shaun McCance <sha...@gnome.org> +Date: Sat Aug 8 13:59:58 2020 +0000 + + Merge branch 'new-templates' into 'master' + + New templates + + See merge request GNOME/yelp-tools!4 + +commit 20c1b7e84f0c5d1b297e1177ce9bcc78cc483eb6 +Author: Shaun McCance <sha...@redhat.com> +Date: Tue Aug 4 08:55:52 2020 -0400 + + Adding docversion and pkgversion to templates + + templates/concept.duck | 3 ++- + templates/concept.page | 3 ++- + templates/guide.duck | 3 ++- + templates/guide.page | 3 ++- + templates/reference.duck | 3 ++- + templates/reference.page | 3 ++- + templates/task.duck | 3 ++- + templates/task.page | 3 ++- + 8 files changed, 16 insertions(+), 8 deletions(-) + +commit 79067c7a2f194d4524e093698bb03a608c2ab8dc +Author: Shaun McCance <sha...@redhat.com> +Date: Sat Jun 13 13:32:12 2020 -0400 + + Initial work on converting yelp-check to python + + tools/yelp-check.py | 1042 +++++++++++++++++++++++++++++++++++++++++++++++++++ + 1 file changed, 1042 insertions(+) + +commit df95ca59879b71c6ae7f433834794860c89904d7 +Author: Shaun McCance <sha...@redhat.com> +Date: Fri May 8 10:50:53 2020 -0400 + + Add new templates to Makefile.am + + templates/Makefile.am | 10 +++++++++- + 1 file changed, 9 insertions(+), 1 deletion(-) + +commit 9a09fdea1a8d409f3fac04a258e6371270dce69b +Author: Shaun McCance <sha...@redhat.com> +Date: Fri May 8 10:47:33 2020 -0400 + + Adding new templates for yelp-new + + templates/concept.duck | 46 +++++++++++++++++++++++ + templates/concept.page | 51 +++++++++++++++++++++++++ + templates/guide.duck | 48 ++++++++++++++++++++++++ + templates/guide.page | 54 ++++++++++++++++++++++++++ + templates/reference.duck | 89 +++++++++++++++++++++++++++++++++++++++++++ + templates/reference.page | 98 ++++++++++++++++++++++++++++++++++++++++++++++++ + templates/task.duck | 62 ++++++++++++++++++++++++++++++ + templates/task.page | 51 +++++++++++++++++++++---- + 8 files changed, 491 insertions(+), 8 deletions(-) + +commit c8664c3df853f5307ff3c4d939721f340d61f4ba +Author: Shaun McCance <sha...@redhat.com> +Date: Wed Jun 12 16:18:31 2019 -0400 + + Version 3.32.2 + + NEWS | 4 ++++ + configure.ac | 2 +- + 2 files changed, 5 insertions(+), 1 deletion(-) + commit 33c0f11607d4aa8404e92fdad09b4fa20eb6a0b2 Author: Shaun McCance <sha...@redhat.com> Date: Wed Jun 12 16:14:46 2019 -0400 diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/yelp-tools-3.32.2/NEWS new/yelp-tools-3.38.0/NEWS --- old/yelp-tools-3.32.2/NEWS 2019-06-12 22:18:01.000000000 +0200 +++ new/yelp-tools-3.38.0/NEWS 2020-09-12 21:42:12.000000000 +0200 @@ -1,3 +1,11 @@ +3.38.0 +====== +* Stable release. No changes since 3.37.90 + +3.37.90 +======= +* yelp-new: Added new templates + 3.32.2 ====== * yelp-build: Fix spurious warning about missing stack files diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/yelp-tools-3.32.2/configure new/yelp-tools-3.38.0/configure --- old/yelp-tools-3.32.2/configure 2019-06-12 22:18:22.000000000 +0200 +++ new/yelp-tools-3.38.0/configure 2020-09-12 21:42:27.000000000 +0200 @@ -1,6 +1,6 @@ #! /bin/sh # Guess values for system-dependent variables and create Makefiles. -# Generated by GNU Autoconf 2.69 for yelp-tools 3.32.2. +# Generated by GNU Autoconf 2.69 for yelp-tools 3.38.0. # # Report bugs to <http://bugzilla.gnome.org/enter_bug.cgi?product=yelp-tools>. # @@ -580,8 +580,8 @@ # Identity of this package. PACKAGE_NAME='yelp-tools' PACKAGE_TARNAME='yelp-tools' -PACKAGE_VERSION='3.32.2' -PACKAGE_STRING='yelp-tools 3.32.2' +PACKAGE_VERSION='3.38.0' +PACKAGE_STRING='yelp-tools 3.38.0' PACKAGE_BUGREPORT='http://bugzilla.gnome.org/enter_bug.cgi?product=yelp-tools' PACKAGE_URL='' @@ -1226,7 +1226,7 @@ # Omit some internal or obsolete options to make the list less imposing. # This message is too long to be a string in the A/UX 3.1 sh. cat <<_ACEOF -\`configure' configures yelp-tools 3.32.2 to adapt to many kinds of systems. +\`configure' configures yelp-tools 3.38.0 to adapt to many kinds of systems. Usage: $0 [OPTION]... [VAR=VALUE]... @@ -1292,7 +1292,7 @@ if test -n "$ac_init_help"; then case $ac_init_help in - short | recursive ) echo "Configuration of yelp-tools 3.32.2:";; + short | recursive ) echo "Configuration of yelp-tools 3.38.0:";; esac cat <<\_ACEOF @@ -1380,7 +1380,7 @@ test -n "$ac_init_help" && exit $ac_status if $ac_init_version; then cat <<\_ACEOF -yelp-tools configure 3.32.2 +yelp-tools configure 3.38.0 generated by GNU Autoconf 2.69 Copyright (C) 2012 Free Software Foundation, Inc. @@ -1397,7 +1397,7 @@ This file contains any messages produced by compilers while running configure, to aid debugging if configure makes a mistake. -It was created by yelp-tools $as_me 3.32.2, which was +It was created by yelp-tools $as_me 3.38.0, which was generated by GNU Autoconf 2.69. Invocation command line was $ $0 $@ @@ -2260,7 +2260,7 @@ # Define the identity of the package. PACKAGE='yelp-tools' - VERSION='3.32.2' + VERSION='3.38.0' cat >>confdefs.h <<_ACEOF @@ -3375,7 +3375,7 @@ # report actual input values of CONFIG_FILES etc. instead of their # values after options handling. ac_log=" -This file was extended by yelp-tools $as_me 3.32.2, which was +This file was extended by yelp-tools $as_me 3.38.0, which was generated by GNU Autoconf 2.69. Invocation command line was CONFIG_FILES = $CONFIG_FILES @@ -3428,7 +3428,7 @@ cat >>$CONFIG_STATUS <<_ACEOF || ac_write_fail=1 ac_cs_config="`$as_echo "$ac_configure_args" | sed 's/^ //; s/[\\""\`\$]/\\\\&/g'`" ac_cs_version="\\ -yelp-tools config.status 3.32.2 +yelp-tools config.status 3.38.0 configured by $0, generated by GNU Autoconf 2.69, with options \\"\$ac_cs_config\\" diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/yelp-tools-3.32.2/configure.ac new/yelp-tools-3.38.0/configure.ac --- old/yelp-tools-3.32.2/configure.ac 2019-06-12 22:18:11.000000000 +0200 +++ new/yelp-tools-3.38.0/configure.ac 2020-09-12 21:42:17.000000000 +0200 @@ -1,4 +1,4 @@ -AC_INIT([yelp-tools], [3.32.2], +AC_INIT([yelp-tools], [3.38.0], [http://bugzilla.gnome.org/enter_bug.cgi?product=yelp-tools]) AM_INIT_AUTOMAKE([1.9 no-dist-gzip dist-bzip2]) diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/yelp-tools-3.32.2/install-sh new/yelp-tools-3.38.0/install-sh --- old/yelp-tools-3.32.2/install-sh 2019-06-12 22:18:22.000000000 +0200 +++ new/yelp-tools-3.38.0/install-sh 2020-09-12 21:42:27.000000000 +0200 @@ -1,4 +1,4 @@ -#!/usr/bin/sh +#!/bin/sh # install - install a program, script, or datafile scriptversion=2018-03-11.20; # UTC diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/yelp-tools-3.32.2/missing new/yelp-tools-3.38.0/missing --- old/yelp-tools-3.32.2/missing 2019-06-12 22:18:22.000000000 +0200 +++ new/yelp-tools-3.38.0/missing 2020-09-12 21:42:27.000000000 +0200 @@ -1,4 +1,4 @@ -#!/usr/bin/sh +#! /bin/sh # Common wrapper for a few potentially missing GNU programs. scriptversion=2018-03-07.03; # UTC diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/yelp-tools-3.32.2/templates/Makefile.am new/yelp-tools-3.38.0/templates/Makefile.am --- old/yelp-tools-3.32.2/templates/Makefile.am 2019-06-12 18:55:57.000000000 +0200 +++ new/yelp-tools-3.38.0/templates/Makefile.am 2020-08-08 16:22:13.000000000 +0200 @@ -1,4 +1,12 @@ tmpldir = $(datadir)/yelp-tools/templates -tmpl_DATA = task.page +tmpl_DATA = \ + concept.duck \ + concept.page \ + guide.duck \ + guide.page \ + reference.duck \ + reference.page \ + task.duck \ + task.page EXTRA_DIST = $(tmpl_DATA) diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/yelp-tools-3.32.2/templates/Makefile.in new/yelp-tools-3.38.0/templates/Makefile.in --- old/yelp-tools-3.32.2/templates/Makefile.in 2019-06-12 22:18:22.000000000 +0200 +++ new/yelp-tools-3.38.0/templates/Makefile.in 2020-09-12 21:42:27.000000000 +0200 @@ -241,7 +241,16 @@ top_builddir = @top_builddir@ top_srcdir = @top_srcdir@ tmpldir = $(datadir)/yelp-tools/templates -tmpl_DATA = task.page +tmpl_DATA = \ + concept.duck \ + concept.page \ + guide.duck \ + guide.page \ + reference.duck \ + reference.page \ + task.duck \ + task.page + EXTRA_DIST = $(tmpl_DATA) all: all-am diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/yelp-tools-3.32.2/templates/concept.duck new/yelp-tools-3.38.0/templates/concept.duck --- old/yelp-tools-3.32.2/templates/concept.duck 1970-01-01 01:00:00.000000000 +0100 +++ new/yelp-tools-3.38.0/templates/concept.duck 2020-08-08 16:22:13.000000000 +0200 @@ -0,0 +1,47 @@ +@ducktype/1.0 +[-] yelp-tmpl-desc Explanation of a concept or background information + += @TITLE@ + [topic .concept version=1.1] + +[-- + Recommended statuses: stub incomplete draft outdated review candidate final + Remove version attributes you don't use. +--] +@revision[version=0.1 docversion=0.1 pkgversion=0.1 date=@DATE@ status=stub] + +@credit[author copyright] + @name @NAME@ + @email @EMAIL@ + @years @YEAR@ + +[-- + This puts a link to this topic on the index page. + Change the xref to link it from another guide. +--] +@link[guide >index] + +[-- + Think about whether other pages should be in the seealso list. + The target page will automatically get a seealso link back. +@link[seealso >someotherid] +--] + +[-- + Think about whether external resources should be in the seealso + list. These require a title. +@link[seealso >>http://someurl] + @title Link title +--] + +@desc Write a short page description here. + +@keywords comma-separated list, of keywords, for search + + +Provide as many paragraphs, lists, or media as necessary to explain. + +[list] +. Next steps +* Optionally, links to other things the user might do now. +* But consider using seealso and other info links instead. diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/yelp-tools-3.32.2/templates/concept.page new/yelp-tools-3.38.0/templates/concept.page --- old/yelp-tools-3.32.2/templates/concept.page 1970-01-01 01:00:00.000000000 +0100 +++ new/yelp-tools-3.38.0/templates/concept.page 2020-08-08 16:22:13.000000000 +0200 @@ -0,0 +1,52 @@ +<?yelp-tmpl-desc Explanation of a concept or background information?> +<page xmlns="http://projectmallard.org/1.0/"; + type="topic" style="concept" version="1.1" + id="@ID@"> + <info> + <!-- + Recommended statuses: stub incomplete draft outdated review candidate final + Remove version attributes you don't use. + --> + <revision version="0.1" docversion="0.1" pkgversion="0.1" date="@DATE@" status="stub"/> + + <credit type="author copyright"> + <name>@NAME@</name> + <email>@EMAIL@</email> + <years>@YEAR@</years> + </credit> + + <!-- + This puts a link to this topic on the index page. + Change the xref to link it from another guide. + --> + <link type="guide" xref="index"/> + + <!-- + Think about whether other pages should be in the seealso list. + The target page will automatically get a seealso link back. + <link type="seealso" xref="someotherid"/> + --> + + <!-- + Think about whether external resources should be in the seealso + list. These require a title. + <link type="seealso" href="http://someurl";> + <title>Link title</title> + </link> + --> + + <desc>Write a short page description here.</desc> + + <keywords>comma-separated list, of keywords, for search</keywords> + </info> + + <title>@TITLE@</title> + + <p>Provide as many paragraphs, lists, or media as necessary to explain.</p> + + <list> + <title>Next steps</title> + <item><p>Optionally, links to other things the user might do now.</p></item> + <item><p>But consider using seealso and other info links instead.</p></item> + </list> +</page> diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/yelp-tools-3.32.2/templates/guide.duck new/yelp-tools-3.38.0/templates/guide.duck --- old/yelp-tools-3.32.2/templates/guide.duck 1970-01-01 01:00:00.000000000 +0100 +++ new/yelp-tools-3.38.0/templates/guide.duck 2020-08-08 16:22:13.000000000 +0200 @@ -0,0 +1,49 @@ +@ducktype/1.0 +[-] yelp-tmpl-desc Navigational glue for Mallard documents + += @TITLE@ + [guide version=1.1] + +[-- + Recommended statuses: stub incomplete draft outdated review candidate final + Remove version attributes you don't use. +--] +@revision[version=0.1 docversion=0.1 pkgversion=0.1 date=@DATE@ status=stub] + +@credit[author copyright] + @name @NAME@ + @email @EMAIL@ + @years @YEAR@ + +[-- + This puts a link to this topic on the index page. + Change the xref to link it from another guide. +--] +@link[guide >index] + +[-- + Think about whether other pages should be in the seealso list. + The target page will automatically get a seealso link back. +@link[seealso >someotherid] +--] + +[-- + Think about whether external resources should be in the seealso + list. These require a title. +@link[seealso >>http://someurl] + @title Link title +--] + +@desc Write a short page description here. + +@keywords comma-separated list, of keywords, for search + + +Optionally, an introductory paragraph. + +[-- + The links element is implicit, but you might want to add one + explicitly if you want to do link grouping or styles. +[links topic .STYLE groups="GROUPS"] + . Optional title +--] diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/yelp-tools-3.32.2/templates/guide.page new/yelp-tools-3.38.0/templates/guide.page --- old/yelp-tools-3.32.2/templates/guide.page 1970-01-01 01:00:00.000000000 +0100 +++ new/yelp-tools-3.38.0/templates/guide.page 2020-08-08 16:22:13.000000000 +0200 @@ -0,0 +1,55 @@ +<?yelp-tmpl-desc Navigational glue for Mallard documents?> +<page xmlns="http://projectmallard.org/1.0/"; + type="guide" version="1.1" + id="@ID@"> + <info> + <!-- + Recommended statuses: stub incomplete draft outdated review candidate final + Remove version attributes you don't use. + --> + <revision version="0.1" docversion="0.1" pkgversion="0.1" date="@DATE@" status="stub"/> + + <credit type="author copyright"> + <name>@NAME@</name> + <email>@EMAIL@</email> + <years>@YEAR@</years> + </credit> + + <!-- + This puts a link to this topic on the index page. + Change the xref to link it from another guide. + --> + <link type="guide" xref="index"/> + + <!-- + Think about whether other pages should be in the seealso list. + The target page will automatically get a seealso link back. + <link type="seealso" xref="someotherid"/> + --> + + <!-- + Think about whether external resources should be in the seealso + list. These require a title. + <link type="seealso" href="http://someurl";> + <title>Link title</title> + </link> + --> + + <desc>Write a short page description here.</desc> + + <keywords>comma-separated list, of keywords, for search</keywords> + </info> + + <title>@TITLE@</title> + + <p>Optionally, an introductory paragraph.</p> + + <!-- + The links element is implicit, but you might want to add one + explicitly if you want to do link grouping or styles. + <links type="topic" style="STYLE" groups="GROUPS"> + <title>Optional title</title> + </links> + --> + +</page> diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/yelp-tools-3.32.2/templates/reference.duck new/yelp-tools-3.38.0/templates/reference.duck --- old/yelp-tools-3.32.2/templates/reference.duck 1970-01-01 01:00:00.000000000 +0100 +++ new/yelp-tools-3.38.0/templates/reference.duck 2020-08-08 16:22:13.000000000 +0200 @@ -0,0 +1,90 @@ +@ducktype/1.0 +[-] yelp-tmpl-desc Lists or tables of information for quick lookup + += @TITLE@ + [topic .reference version=1.1] + +[-- + Recommended statuses: stub incomplete draft outdated review candidate final + Remove version attributes you don't use. +--] +@revision[version=0.1 docversion=0.1 pkgversion=0.1 date=@DATE@ status=stub] + +@credit[author copyright] + @name @NAME@ + @email @EMAIL@ + @years @YEAR@ + +[-- + This puts a link to this topic on the index page. + Change the xref to link it from another guide. +--] +@link[guide >index] + +[-- + Think about whether other pages should be in the seealso list. + The target page will automatically get a seealso link back. +@link[seealso >someotherid] +--] + +[-- + Think about whether external resources should be in the seealso + list. These require a title. +@link[seealso >>http://someurl] + @title Link title +--] + +@desc Write a short page description here. + +@keywords comma-separated list, of keywords, for search + + +Optionally provide introductory text. +Use terms lists, tables, and bullet lists for reference material. + + +[terms] +. Example terms list (title optional) + +- Term 1 +* Description + +- Term 2 +* Terms can have multiple paragraphs. + + [screen] + Or any other block element. + +- Term 3.1 +- Term 3.2 +* Terms can also have multiple titles. + + +[table] +. Example table (title optional) + +[thead] +[tr] +- Column 1 +- Column 2 + +[tbody] +[tr] +* Row 1, column 1 +* Row 1, column 2 + +[tr] +* Row 2, column 1 +* Row 2, column 2 + + +[list] +. Example list (title optional) + +* Item 1 + +* Item 2 + * Subitem 2.1 + * Subitem 2.2 + +* Item 3 diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/yelp-tools-3.32.2/templates/reference.page new/yelp-tools-3.38.0/templates/reference.page --- old/yelp-tools-3.32.2/templates/reference.page 1970-01-01 01:00:00.000000000 +0100 +++ new/yelp-tools-3.38.0/templates/reference.page 2020-08-08 16:22:13.000000000 +0200 @@ -0,0 +1,99 @@ +<?yelp-tmpl-desc Lists or tables of information for quick lookup?> +<page xmlns="http://projectmallard.org/1.0/"; + type="topic" style="reference" version="1.1" + id="@ID@"> + <info> + <!-- + Recommended statuses: stub incomplete draft outdated review candidate final + Remove version attributes you don't use. + --> + <revision version="0.1" docversion="0.1" pkgversion="0.1" date="@DATE@" status="stub"/> + + <credit type="author copyright"> + <name>@NAME@</name> + <email>@EMAIL@</email> + <years>@YEAR@</years> + </credit> + + <!-- + This puts a link to this topic on the index page. + Change the xref to link it from another guide. + --> + <link type="guide" xref="index"/> + + <!-- + Think about whether other pages should be in the seealso list. + The target page will automatically get a seealso link back. + <link type="seealso" xref="someotherid"/> + --> + + <!-- + Think about whether external resources should be in the seealso + list. These require a title. + <link type="seealso" href="http://someurl";> + <title>Link title</title> + </link> + --> + + <desc>Write a short page description here.</desc> + + <keywords>comma-separated list, of keywords, for search</keywords> + </info> + + <title>@TITLE@</title> + + <p>Optionally provide introductory text. + Use terms lists, tables, and bullet lists for reference material.</p> + + <terms> + <title>Example terms list (title optional)</title> + <item> + <title>Term 1</title> + <para>Description</para> + </item> + <item> + <title>Term 2</title> + <p>Terms can have multiple paragraphs.</p> + <screen>Or any other block element.</screen> + </item> + <item> + <title>Term 3.1</title> + <title>Term 3.2</title> + <p>Terms can also have multiple titles.</p> + </item> + </terms> + + <table> + <title>Example table (title optional)</title> + <thead> + <tr> + <th>Column 1</th> + <th>Column 2</th> + </tr> + </thead> + <tbody> + <tr> + <td>Row 1, column 1</td> + <td>Row 1, column 2</td> + </tr> + <tr> + <td>Row 2, column 1</td> + <td>Row 2, column 2</td> + </tr> + </tbody> + </table> + + <list> + <title>Example list (title optional)</title> + <item><p>Item 1</p></item> + <item> + <p>Item 2</p> + <list> + <item><p>Subitem 2.1</p></item> + <item><p>Subitem 2.2</p></item> + </list> + </item> + <item><p>Item 3</p></item> + </list> + +</page> diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/yelp-tools-3.32.2/templates/task.duck new/yelp-tools-3.38.0/templates/task.duck --- old/yelp-tools-3.32.2/templates/task.duck 1970-01-01 01:00:00.000000000 +0100 +++ new/yelp-tools-3.38.0/templates/task.duck 2020-08-08 16:22:13.000000000 +0200 @@ -0,0 +1,63 @@ +@ducktype/1.0 +[-] yelp-tmpl-desc Description of how to accomplish a user task + += @TITLE@ + [topic .task version=1.1] + +[-- + Recommended statuses: stub incomplete draft outdated review candidate final + Remove version attributes you don't use. +--] +@revision[version=0.1 docversion=0.1 pkgversion=0.1 date=@DATE@ status=stub] + +@credit[author copyright] + @name @NAME@ + @email @EMAIL@ + @years @YEAR@ + +[-- + This puts a link to this topic on the index page. + Change the xref to link it from another guide. +--] +@link[guide >index] + +[-- + Think about whether other pages should be in the seealso list. + The target page will automatically get a seealso link back. +@link[seealso >someotherid] +--] + +[-- + Think about whether external resources should be in the seealso + list. These require a title. +@link[seealso >>http://someurl] + @title Link title +--] + +@desc Write a short page description here. + +@keywords comma-separated list, of keywords, for search + + +Short introductory text: Write a couple sentences about what the +user is doing here, and why they might want to do it. + +[list] +. Prerequisites +* Optionally, list things the user needs to know or do first. +* Use links to other pages whenever they make sense. + +[steps] +. Optional title if different from page title or if prereqs present +* First step... +* Second step... +* Third step... + +Optionally, write expected results if non-obvious. + +[list] +. Next steps +* Optionally, links to other things the user might do now. +* But consider using seealso and other info links instead. + + diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/yelp-tools-3.32.2/templates/task.page new/yelp-tools-3.38.0/templates/task.page --- old/yelp-tools-3.32.2/templates/task.page 2019-06-12 18:55:57.000000000 +0200 +++ new/yelp-tools-3.38.0/templates/task.page 2020-08-08 16:22:13.000000000 +0200 @@ -1,9 +1,13 @@ <?yelp-tmpl-desc Description of how to accomplish a user task?> <page xmlns="http://projectmallard.org/1.0/"; - type="topic" style="task" + type="topic" style="task" version="1.1" id="@ID@"> <info> - <revision version="0.1" date="@DATE@" status="stub"/> + <!-- + Recommended statuses: stub incomplete draft outdated review candidate final + Remove version attributes you don't use. + --> + <revision version="0.1" docversion="0.1" pkgversion="0.1" date="@DATE@" status="stub"/> <credit type="author copyright"> <name>@NAME@</name> @@ -11,23 +15,55 @@ <years>@YEAR@</years> </credit> - <desc></desc> + <!-- + This puts a link to this topic on the index page. + Change the xref to link it from another guide. + --> + <link type="guide" xref="index"/> + + <!-- + Think about whether other pages should be in the seealso list. + The target page will automatically get a seealso link back. + <link type="seealso" xref="someotherid"/> + --> + + <!-- + Think about whether external resources should be in the seealso + list. These require a title. + <link type="seealso" href="http://someurl";> + <title>Link title</title> + </link> + --> + + <desc>Write a short page description here.</desc> + + <keywords>comma-separated list, of keywords, for search</keywords> </info> <title>@TITLE@</title> - <comment> - <cite date="@DATE@" href="mailto:@EMAIL@";>@NAME@</cite> - <p>This assumes the reader knows how to.... By the end of this page, - the reader will be able to....</p> - </comment> + <p>Short introductory text: Write a couple sentences about what the + user is doing here, and why they might want to do it.</p> - <p>Short introductory text...</p> + <list> + <title>Prerequisites</title> + <item><p>Optionally, list things the user needs to know or do first.</p></item> + <item><p>Use links to other pages whenever they make sense.</p></item> + </list> <steps> + <title>Optional title if different from page title or if prereqs present</title> <item><p>First step...</p></item> <item><p>Second step...</p></item> <item><p>Third step...</p></item> </steps> + <p>Optionally, write expected results if non-obvious.</p> + + <list> + <title>Next steps</title> + <item><p>Optionally, links to other things the user might do now.</p></item> + <item><p>But consider using seealso and other info links instead.</p></item> + </list> + </page> _______________________________________________ openSUSE Commits mailing list -- commit@lists.opensuse.org To unsubscribe, email commit-le...@lists.opensuse.org List Netiquette: https://en.opensuse.org/openSUSE:Mailing_list_netiquette List Archives: https://lists.opensuse.org/archives/list/commit@lists.opensuse.org
