Bug 666846

Summary: counterpart keyword for '#raw' is '#end raw' not '#endraw'
Product: Red Hat Satellite 5 Reporter: Martin Osvald 🛹 <mosvald>
Component: Docs Deployment GuideAssignee: Lana Brindley <lbrindle>
Status: CLOSED CURRENTRELEASE QA Contact: Pavel Novotny <pnovotny>
Severity: medium Docs Contact:
Priority: medium    
Version: 540CC: cperry, james.leddy, mhideo, mmello, pnovotny
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2011-06-16 22:15:42 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On:    
Bug Blocks: 644722, 677505, 678080    

Description Martin Osvald 🛹 2011-01-03 12:12:30 UTC
Description of problem:

Red Hat Network Deployment guide contains a bug in a section 'Escaping Special Characeters'. It mentions that counterpart for '#raw' keyword is '#endraw', but it is wrong.


Version-Release number of selected component (if applicable):

Deployment guide for Sat 5.3 and 5.4


Steps to Reproduce:

see the following url (section '5.7.3.2. Escaping Special Characeters'):

"""
A second method is to wrap the entire script in #raw ... #endraw :

%post 
#raw  
echo $foo > /tmp/foo.txt 
#endraw
"""

http://docs.redhat.com/docs/en-US/Red_Hat_Network_Satellite/5.4/html/Deployment_Guide/s1-provisioning-templates.html#s2-provisioning-templates-snippets


Actual results:

raw kickstart (stored in /var/lib/rhn/kickstarts/wizard; NET variable was defined and is only example to show variable substitution doesn't work when '#endraw' is used):

echo "1: $NET"
#raw
echo "2: $NET"
#endraw
echo "3: $NET"

output from WebUI or 'cobbler profile getks' command when using '#endraw' instead of '#end raw':

echo "1: 111"
echo "2: $NET"
#endraw              <<<--- '#endraw' keyword remains in output
echo "3: $NET"       <<<--- NET doesn't get substituted with value 111


Expected results:

The manual should mention '#end raw' instead of '#endraw'.


Additional info:

The correct documentation for '#end raw' keyword can be found here (section 'Raw Escaping'):

https://fedorahosted.org/cobbler/wiki/KickstartTemplating

Comment 1 Lana Brindley 2011-01-03 19:49:47 UTC
Added to content spec for Deployment Guide review.

LKB

Comment 2 Lana Brindley 2011-03-22 03:29:06 UTC
Replaced #endraw with #end raw in "Escaping Special Characters" section, Kickstart chapter, new User Guide.

LKB

Comment 3 Pavel Novotny 2011-04-21 12:25:21 UTC
Taking this bug for verification.

Comment 4 Pavel Novotny 2011-04-21 17:30:36 UTC
(In reply to comment #2)
> Replaced #endraw with #end raw in "Escaping Special Characters" section,
> Kickstart chapter, new User Guide.
> 
> LKB

Verified
in Satellite 5.4.1 "Getting Started Guide", section "2.4. Templating".

Comment 5 Lana Brindley 2011-05-06 00:19:24 UTC
This book has now been dropped to translation (RT#75265).
No further updates can be accepted. Please raise a new bug for any changes.
LKB

Comment 7 Lana Brindley 2011-06-16 22:15:42 UTC
5.4.1 Satellite books are now available on docs.redhat.com. Please raise a new bug for any issues.

LKB