[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#805023: debian-refcard: Refcard boundaries of each command or group of commands are not correct



 On Fri, 13 Nov 2015 13:54:01 Raphaël Bazaud wrote:
> I've noticed the problem of boundaries inside each stanza, or group of
commands

Raphaël, I'm not sure what you mean by 'boundaries' here. Does the
problem you mention manifest in the XML source (entries.dbk) or in the
output? If the latter, how did you transform the document? I noticed
yesterday that transforming it to HTML with docbook2html gives bad
results, but that using the included XSL file (html.xsl) output a
reasonable HTML file which AFAICT doesn't have any boundary problems of
the type you're talking about.

I've attached the diff I made yesterday, just for the sake of
completeness; it's pretty much the same as Raphaël's but longer. Also
it's probably the wrong format because I'm still learning to diff.
196c196,208
<       <glossentry id="restart">
---
>       <glossentry id="service-restart">
> 	<glossterm><command>service<replaceable>file</replaceable></command>
> 	restart</glossterm>
> 	<glossdef><para>Restart a service, system
> 	daemon.</para></glossdef>
>       </glossentry>
>       <glossentry id="systemd-restart">
> 	<glossterm><command>systemctl restart</command><replaceable>file</replaceable>
> 	restart</glossterm>
> 	<glossdef><para>Restart a service, system
> 	daemon.</para></glossdef>
>       </glossentry>
>       <glossentry id="sysvinit-restart">
202c214,226
<       <glossentry id="stop">
---
>       <glossentry id="service-stop">
> 	<glossterm><command>service<replaceable>file</replaceable></command>
> 	stop</glossterm>
> 	<glossdef><para>Stop a service, system
> 	daemon.</para></glossdef>
>       </glossentry>
>       <glossentry id="systemd-stop">
> 	<glossterm><command>systemctl stop<replaceable>file</replaceable></command>
> 	stop</glossterm>
> 	<glossdef><para>Stop a service, system
> 	daemon.</para></glossdef>
>       </glossentry>
>       <glossentry id="sysvinit-stop">
208c232,244
<       <glossentry id="start">
---
>       <glossentry id="service-start">
> 	<glossterm><command>service<replaceable>file</replaceable></command>
> 	start</glossterm>
> 	<glossdef><para>Start a service, system
> 	daemon.</para></glossdef>
>       </glossentry>
>       <glossentry id="systemd-start">
> 	<glossterm><command>systemctl start<replaceable>file</replaceable></command>
> 	start</glossterm>
> 	<glossdef><para>Start a service, system
> 	daemon.</para></glossdef>
>       </glossentry>
>       <glossentry id="sysvinit-start">
219c255
<       <glossentry id="var-log">
---
>       <glossentry id="sysvinit-var-log">
222a259,262
>       </glossentry>
>       <glossentry id="journalctl">
> 	<glossterm><command>journalctl</filename></glossterm>
> 	<glossdef><para>The systemd journal (journald.service) is a centralized repository of log information. Use the <command>journalctl</command> program to view this information.</para></glossdef>

Reply to: