Bug 828859

Summary: AutoYaST documentation regarding "Printer" is outdated for openSUSE
Product: [openSUSE] openSUSE Tumbleweed Reporter: Johannes Meixner <jsmeix>
Component: DocumentationAssignee: Frank Sundermeyer <fs>
Status: VERIFIED FIXED QA Contact: Karl Eichwalder <ke>
Severity: Normal    
Priority: P5 - None CC: bugs, fs, rsalevsky, tgoettlicher
Version: 13.1 Milestone 2   
Target Milestone: ---   
Hardware: All   
OS: SUSE Other   
Whiteboard:
Found By: Development Services Priority:
Business Priority: Blocker: ---
Marketing QA Status: --- IT Deployment: ---
Attachments: autoyast-printer-docu-bnc828859.txt

Description Johannes Meixner 2013-07-10 13:01:52 UTC 
Rick Salevsky found the following documentaion:
http://doc.opensuse.org/projects/autoyast/configuration.html

I don't know for what exact openSUSE version that documentation is
nor do I know from what sources that documentation is generated.

Therein section "4.21.1 Printer" contains mostly the right text
except some minor adjustments.
I will attach later a corrected text for current openSUSE versions.

But below the "Example 4.37: Printer configuration" is plain wrong
for current openSUSE versions.

It is the outdated XML that was valid for SLE11
which is no longer valid since something like openSUSE 11.3
when I made the AutoYaST "Printer" stuff completely anew,
(see bnc#588679 and bnc#582680 if you like all details ;-)

Regarding "the new AutoYaST control file structure" see
https://bugzilla.novell.com/show_bug.cgi?id=588679#c10
-----------------------------------------------------------
  <printer>
    <client_conf_content>
      <file_contents><![CDATA[
... verbatim content of /etc/cups/client.conf ...
]]></file_contents>
    </client_conf_content>
    <cupsd_conf_content>
      <file_contents><![CDATA[
... verbatim content of /etc/cups/cupsd.conf ...
]]></file_contents>
    </cupsd_conf_content>
  </printer>
-----------------------------------------------------------

Therefore the "Example 4.37: Printer configuration" should be
exchanged by "the new AutoYaST control file structure" above.
Comment 2 Frank Sundermeyer 2013-07-11 12:59:22 UTC 
* http://doc.opensuse.org/projects/autoyast/configuration.html applies to openSUSE 12.3 as is stated on the web page

* The AutoYaST documentation sources are hosted on svn.opensuse.org
Comment 3 Frank Sundermeyer 2013-07-11 13:00:21 UTC 
Thomas, is this an update you can do?
Comment 4 Thomas Fehr 2013-07-11 13:10:50 UTC 
I have no idea about printer setup neither in YaST nor in autoyast.
This is done via clients from printer module which autoyast code
calls.  

So it would make most sense if Johannes tells you directly what
should be changed printer chapter in of autoyast documentation.
I do not see much to gain if I would play man-in-the middle.
Comment 6 Johannes Meixner 2013-07-18 13:52:36 UTC 
Created attachment 548494 [details]
autoyast-printer-docu-bnc828859.txt

Updated text plus updated XML.
Comment 7 Frank Sundermeyer 2013-10-01 13:42:06 UTC 
Fixed for openSUSE 13.1
Comment 8 Johannes Meixner 2013-10-02 11:03:22 UTC 
FYI:

The AutoYaST documentation regarding "Printer"
must be updated again for openSUSE 13.2, see
https://bugzilla.novell.com/show_bug.cgi?id=735404#c51
Comment 9 Johannes Meixner 2014-04-03 13:32:51 UTC 
The AutoYaST documentation at

http://doc.opensuse.org/projects/autoyast/configuration.html#CreateProfile.Hardware.Printer

is still wrong.

As far as I see it is exactly the same as it was
at the time of comment#0 - i.e. nothing seems to have
been fixed at that public accessible URL.

As a result I get bug reports because the users
still use the old syntax, see bnc#871677
Comment 10 Thomas Göttlicher 2014-04-03 14:40:36 UTC 
(In reply to comment #9)
> The AutoYaST documentation at
> 
> http://doc.opensuse.org/projects/autoyast/configuration.html#CreateProfile.Hardware.Printer
> 
> is still wrong.
> 

I don't expect that location to be updated anymore because http://doc.opensuse.org has following notice:
"Since openSUSE 13.1 all openSUSE related documentation moved to our community editing server ActiveDoc.opensuse.org and the links below are only retained here for reference.".
Comment 11 Johannes Meixner 2014-04-03 14:47:56 UTC 
I cannot find the AutoYaST documentation at
http://activedoc.opensuse.org/
Comment 12 Frank Sundermeyer 2014-04-04 12:13:07 UTC 
Sorry, I forgot to update doc.opensuse.org way back when applying the patch from comment #6.  http://doc.opensuse.org/projects/autoyast/ should be up-to-date now.
Comment 14 Johannes Meixner 2014-04-04 12:24:22 UTC 
Very many thanks for that!

From comment#10 I thought the AutoYaST documentation might be
left unmaintained on http://doc.opensuse.org/projects/autoyast/

Hereby I confirm that section "4.21.1 Printer" in now correct at
http://doc.opensuse.org/projects/autoyast/configuration.html#CreateProfile.Hardware