printing-doc: Fix links and typos, enhance content

This commit is contained in:
Zdenek Dohnal 2022-02-10 07:36:14 +01:00
parent 5f77868da4
commit 2d14cf584f
2 changed files with 13 additions and 4 deletions

View file

@ -10,7 +10,16 @@ Problems involving printing may relate to several components.
The configuration GUI (See above) is either https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&component=control-center[GNOME 3 System Settings application] or https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&component=system-config-printer[system-config-printer]. These packages also provide the printer applet, handle automatic queue creation, and disable/enable queues when USB printers are disconnected and reconnected. The configuration GUI (See above) is either https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&component=control-center[GNOME 3 System Settings application] or https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&component=system-config-printer[system-config-printer]. These packages also provide the printer applet, handle automatic queue creation, and disable/enable queues when USB printers are disconnected and reconnected.
Most GTK+ applications use the GTK+ print dialog. If the problem occurs when using GTK+ applications but not when printing from the command line or from another non-GTK+ application, the problem should probably be reported against https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&component=gtk2[gtk2]. If the problem occurs with only one GTK+ application, and other GTK+ applications print fine, the bug should be filed against that particular application. Most GTK+ applications use the GTK+ print dialog. If the problem occurs when using GTK+ applications but not when printing from the command line or from another non-GTK+ application, the problem should probably be reported against the GTK+ version which the application uses. You can find out the version by the following query (*thunderbird* is used as an example of RPM package):
----
$ rpm -q thunderbird | grep gtk
libgtk-3.so.0
----
From the output you can see *thunderbird* uses GTK+ version 3.
If the problem occurs with only one GTK+ application, and other GTK+ applications print fine, the bug should be filed against that particular application.
If the problem only happens with PDF files, the bug may well be in https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&component=poppler[poppler] (the CUPS *pdftops* filter is a wrapper around one of the poppler utility programs). If the problem only happens with PDF files, the bug may well be in https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&component=poppler[poppler] (the CUPS *pdftops* filter is a wrapper around one of the poppler utility programs).
@ -35,7 +44,7 @@ Be prepared to include some information about your system as well.
=== Before gathering of information === Before gathering of information
* Please change your OS locale to English. Manual xref:f{MAJOROSVER}@fedora:system-administrators-guide:basic-system-configuration/System_Locale_and_Keyboard_Configuration.adoc[[1\]]. * Please change your OS locale to English.
* Please attach gathered information as archive (example is xref:cups-useful-tricks.adoc#_how_to_compress_files[here], you may need root permissions) to the bugzilla issue. * Please attach gathered information as archive (example is xref:cups-useful-tricks.adoc#_how_to_compress_files[here], you may need root permissions) to the bugzilla issue.
* Please do not forget to trigger your issue after debug enabling and restarting cups and before information gathering. * Please do not forget to trigger your issue after debug enabling and restarting cups and before information gathering.
@ -62,4 +71,4 @@ Some example documents can be found in the https://fedoraproject.org/wiki/Catego
== Further reading == Further reading
The https://fedoraproject.org/wiki/Printing[main printing page] has more information about how printing works in Fedora. The https://fedoraproject.org/wiki/Printing[main printing page] and the xref:cups-terminology.adoc#_printing[printing terminology page] have more information about how printing works in Fedora.

View file

@ -4,7 +4,7 @@ ifdef::context[:parent-context: {context}]
= How to debug printing problems = How to debug printing problems
:toc: :toc:
If you are experiencing a problem with printing, please take a look at the https://fedoraproject.org/wiki/Bugs/Common[common bugs] page before filing a bug. If the problem you are seeing is not listed there or none of the workarounds seem to help, please consider https://fedoraproject.org/wiki/How_to_debug_printing_problems#Filing_a_bug_report[filing a bug report] to help us make Fedora run better on your hardware. If you are experiencing a problem with printing, please take a look at the https://fedoraproject.org/wiki/Bugs/Common[common bugs] page before filing a bug. If the problem you are seeing is not listed there or none of the workarounds seem to help, please consider xref:cups-filing-a-bug-report.adoc#_filing_a_bug_report[filing a bug report] to help us make Fedora run better on your hardware.
include::{partialsdir}/proc_cups-identifying-your-problem-area.adoc[leveloffset=+1] include::{partialsdir}/proc_cups-identifying-your-problem-area.adoc[leveloffset=+1]
include::{partialsdir}/con_cups-user-stories.adoc[leveloffset=+1] include::{partialsdir}/con_cups-user-stories.adoc[leveloffset=+1]