From 2d14cf584fc26b52e869f8713b9af7ca3ebbb6ca Mon Sep 17 00:00:00 2001 From: Zdenek Dohnal Date: Thu, 10 Feb 2022 07:36:14 +0100 Subject: [PATCH] printing-doc: Fix links and typos, enhance content --- .../_partials/proc_cups-filing-a-bug-report.adoc | 15 ++++++++++++--- .../pages/how-to-debug-printing-problems.adoc | 2 +- 2 files changed, 13 insertions(+), 4 deletions(-) diff --git a/modules/ROOT/pages/_partials/proc_cups-filing-a-bug-report.adoc b/modules/ROOT/pages/_partials/proc_cups-filing-a-bug-report.adoc index 9a7c9f7..5941575 100644 --- a/modules/ROOT/pages/_partials/proc_cups-filing-a-bug-report.adoc +++ b/modules/ROOT/pages/_partials/proc_cups-filing-a-bug-report.adoc @@ -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. -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). @@ -35,7 +44,7 @@ Be prepared to include some information about your system as well. === 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 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 -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. diff --git a/modules/ROOT/pages/how-to-debug-printing-problems.adoc b/modules/ROOT/pages/how-to-debug-printing-problems.adoc index 9f959e8..6c50595 100644 --- a/modules/ROOT/pages/how-to-debug-printing-problems.adoc +++ b/modules/ROOT/pages/how-to-debug-printing-problems.adoc @@ -4,7 +4,7 @@ ifdef::context[:parent-context: {context}] = How to debug printing problems :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}/con_cups-user-stories.adoc[leveloffset=+1]