Bug 138269

Summary: [patch] [Handbook] add a section about installing a random linux rpm-based application
Product: Documentation Reporter: Boris Samorodov <bsam>
Component: Books & ArticlesAssignee: Marc Fonvieille <blackend>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
linux.rpm.diff
none
linuxemu.diff none

Description Boris Samorodov freebsd_committer freebsd_triage 2009-08-28 14:40:06 UTC
	This is one most frequently asked questions at freebsd-question@
	and freebsd-emulation@ mail lists and is not covered at any
	official documents.

Fix: This is my first try to use sgml format, so please be indulgent. ;-)



-- 
WBR, bsam--ghQNoqANLklimRcZOGbnq9mZYNSzIUmjADlBrZXdXx4XJzbO
Content-Type: text/plain; name="linux.rpm.diff"
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment; filename="linux.rpm.diff"

Index: chapter.sgml
===================================================================
RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/handbook/linuxemu/chapter.sgml,v
retrieving revision 1.138
diff -u -r1.138 chapter.sgml
--- chapter.sgml	27 Aug 2009 12:48:48 -0000	1.138
+++ chapter.sgml	28 Aug 2009 13:28:06 -0000
@@ -349,6 +349,24 @@
 	<literal>bind</literal> if you have not configured a name server
 	using the <filename>/etc/resolv.conf</filename> file.</para>
     </sect2>
+
+    <sect2>
+      <title>Installing a Random Linux RPM Based Application</title>
+
+      <para>FreeBSD has it's own package database and it is used to track
+	all ports (linux ports as well). So the Linux rpm database is not
+	used (not supported).</para>
+
+      <para>However if you need to install a random Linux rpm-based
+	application it can de achieved by:</para>
+
+      <screen>&prompt.root; <userinput>cd /compat/linux</userinput></screen>
+      <screen>&prompt.root; <userinput>rpm2cpio -q < /path/to/linux.archieve.rpm | cpio -id</userinput></screen>
+
+      <para>Then brandelf installed ELF binaries (not libraries!).
+	You won't be able to do a clean uninstall, but it may help you
+	to do tests.<para/>
+    </sect2>
   </sect1>
 
   <sect1 id="linuxemu-mathematica">
Comment 1 Marc Fonvieille freebsd_committer freebsd_triage 2009-08-28 15:08:48 UTC
Responsible Changed
From-To: freebsd-doc->blackend

I will help bsam to polish and commit this one.
Comment 2 Marc Fonvieille freebsd_committer freebsd_triage 2009-08-29 08:56:28 UTC
On Fri, Aug 28, 2009 at 05:36:44PM +0400, Boris Samorodov wrote:
> 
> >Number:         138269
> >Category:       docs
> >Synopsis:       [patch] the Handbook: add a section about installing a random linux rpm-based application
> >Confidential:   no
> >Severity:       non-critical
> >Priority:       low
> >Responsible:    freebsd-doc
> >State:          closed
> >Quarter:        
> >Keywords:       
> >Date-Required:
> >Class:          update
> >Submitter-Id:   current-users
> >Arrival-Date:   Fri Aug 28 13:40:06 UTC 2009
> >Closed-Date:
> >Last-Modified:
> >Originator:     Boris Samorodov
> >Release:        FreeBSD 8.0-BETA3 i386
> >Organization:
> InPharmTech, Co.
> >Environment:
> System: FreeBSD bb.ipt.ru 8.0-BETA3 FreeBSD 8.0-BETA3 #2: Mon Aug 24 16:06:36 MSD 2009 root@bb.ipt.ru:/usr/obj/usr/src/sys/BB i386
> 
> >Description:
> 	This is one most frequently asked questions at freebsd-question@
> 	and freebsd-emulation@ mail lists and is not covered at any
> 	official documents.
> >How-To-Repeat:
> >Fix:
> 	This is my first try to use sgml format, so please be indulgent. ;-)
> 
> --- linux.rpm.diff begins here ---
> Index: chapter.sgml
> ===================================================================
> RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/handbook/linuxemu/chapter.sgml,v
> retrieving revision 1.138
> diff -u -r1.138 chapter.sgml
> --- chapter.sgml	27 Aug 2009 12:48:48 -0000	1.138
> +++ chapter.sgml	28 Aug 2009 13:28:06 -0000
> @@ -349,6 +349,24 @@
>  	<literal>bind</literal> if you have not configured a name server
>  	using the <filename>/etc/resolv.conf</filename> file.</para>
>      </sect2>

Actually I'd put your section just before, I mean just under the one
about "Installing Linux ELF Binaries"

> +
> +    <sect2>
> +      <title>Installing a Random Linux RPM Based Application</title>
> +
> +      <para>FreeBSD has it's own package database and it is used to track

                           ^ its ?

> +	all ports (linux ports as well). So the Linux rpm database is not
                                                      ^--- RPM ?

                   ^ linux or Linux?    ^----------- we use to put 2 whitespace
		   you should use &linux;            after a fullstop
		   to avoid such dilema :)

> +	used (not supported).</para>
> +
> +      <para>However if you need to install a random Linux rpm-based

                                                             ^ RPM

> +	application it can de achieved by:</para>

                           ^ be?

> +
> +      <screen>&prompt.root; <userinput>cd /compat/linux</userinput></screen>
> +      <screen>&prompt.root; <userinput>rpm2cpio -q < /path/to/linux.archieve.rpm | cpio -id</userinput></screen>

a best solution in term of rendering should be with one
<screen></screen> couple, i.e,

	<screen>&prompt.root; <userinput>cd /compat/linux</userinput></screen>
&prompt.root; <userinput>rpm2cpio -q &lt; /path/to/linux.archive.rpm | cpio -id</userinput></screen>

I also did a s/</&lt; and a s/archieve/archive/

> +
> +      <para>Then brandelf installed ELF binaries (not libraries!).
> +	You won't be able to do a clean uninstall, but it may help you

            ^ we do not use contraction in docs so "You will not"

> +	to do tests.<para/>
> +    </sect2>
>    </sect1>
>  
>    <sect1 id="linuxemu-mathematica">
> --- linux.rpm.diff ends here ---
> 
> -- 
> WBR, bsam
> >Release-Note:
> >Audit-Trail:
> >Unformatted:
> _______________________________________________
> freebsd-doc@freebsd.org mailing list
> http://lists.freebsd.org/mailman/listinfo/freebsd-doc
> To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org"

-- 
Marc
Comment 3 Boris B.Samorodov 2009-08-29 11:18:22 UTC
Agreed for all your comments. Here is the revised patch.
Comment 4 Marc Fonvieille freebsd_committer freebsd_triage 2009-08-29 14:09:27 UTC
On Sat, Aug 29, 2009 at 02:18:22PM +0400, Boris Samorodov wrote:
> Wow, too many errors for a couple of sentences. I suspected something
> like this, but not so many. Thanks for your help!
> 
> Agreed for all your comments. Here is the revised patch.

> Index: chapter.sgml
> ===================================================================
> RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/handbook/linuxemu/chapter.sgml,v
> retrieving revision 1.138
> diff -u -r1.138 chapter.sgml
> --- chapter.sgml	27 Aug 2009 12:48:48 -0000	1.138
> +++ chapter.sgml	29 Aug 2009 10:15:59 -0000
> @@ -326,6 +326,24 @@
>      </sect2>
>  
>      <sect2>
> +      <title>Installing a Random Linux RPM Based Application</title>
> +
> +      <para>FreeBSD has its own package database and it is used to track
> +	all ports (&linux ports as well).  So the &linux RPM database is not

                         ^ a missing ; after            ^ same here
			 an entity

> +	used (not supported).</para>
> +
> +      <para>However if you need to install a random &linux RPM-based
> +	application it can be achieved by:</para>
> +
> +      <screen>&prompt.root; <userinput>cd /compat/linux</userinput>
> +&prompt.root; <userinput>rpm2cpio -q &lt; /path/to/linux.archive.rpm | cpio -id</userinput></screen>
> +
> +      <para>Then brandelf installed ELF binaries (not libraries!).
> +	You will not be able to do a clean uninstall, but it may help you
> +	to do tests.<para/>

                     ^^^^ should be </para>

> +    </sect2>
> +
> +    <sect2>
>        <title>Configuring the Hostname Resolver</title>
>  
>        <para>If DNS does not work or you get this message:</para>

> 

Do the changes and a test build, if it doesn't fail you're free to
commit it :)


-- 
Marc
Comment 5 Marc Fonvieille freebsd_committer freebsd_triage 2009-08-31 17:47:00 UTC
On Mon, Aug 31, 2009 at 01:28:30PM +0400, Boris Samorodov wrote:
> Here is a revised patch (compiled OK and looks so far good to me):
[...]

Looks Ok here.  You should commit it.

-- 
Marc
Comment 6 dfilter service freebsd_committer freebsd_triage 2009-08-31 19:02:41 UTC
bsam        2009-08-31 18:02:32 UTC

  FreeBSD doc repository (ports committer)

  Modified files:
    en_US.ISO8859-1/books/handbook/linuxemu chapter.sgml 
  Log:
  Add a section about installing a random Linux RPM-based application.
  
  PR:             docs/138269
  Submitted by:   bsam (me)
  Approved by:    blackend (thanks for help!)
  
  Revision  Changes    Path
  1.139     +18 -0     doc/en_US.ISO8859-1/books/handbook/linuxemu/chapter.sgml
_______________________________________________
cvs-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/cvs-all
To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
Comment 7 Boris Samorodov freebsd_committer freebsd_triage 2009-08-31 19:03:11 UTC
State Changed
From-To: open->closed

Committed, thanks!