netbsd-docs: [docathon] converted Ports/sh3/faq.list

Subject: [docathon] converted Ports/sh3/faq.list
To: None <netbsd-docs@netbsd.org>
From: None <dsieger@techfak.uni-bielefeld.de>
List: netbsd-docs
Date: 04/07/2007 00:41:44
--j+MD90OnwjQyWNYt
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline

Ports/sh3/faq.list converted. patch attached.

Note: If you're committing a patch, please be sure to update the
according status entry at 

http://wiki.netbsd.se/index.php/Hackathon5#List_of_.list_files

Thanks,
Daniel

-- 
Daniel Sieger
Faculty of Technology
Bielefeld University
wwwhomes.uni-bielefeld.de/dsieger

--j+MD90OnwjQyWNYt
Content-Type: text/plain; charset=us-ascii
Content-Disposition: attachment; filename="sh3-faq.diff"

Index: layout.xml
===================================================================
RCS file: /cvsroot/htdocs/layout.xml,v
retrieving revision 1.244
diff -u -r1.244 layout.xml
--- layout.xml	6 Apr 2007 21:14:26 -0000	1.244
+++ layout.xml	6 Apr 2007 22:37:13 -0000
@@ -291,13 +291,16 @@
       <tocentry page="Ports/sgimips/index.xml" dir="sgimips" filename=".">
         <tocentry page="Ports/sgimips/faq.xml" filename="faq.html"/>
       </tocentry>
-      <tocentry page="Ports/sh3/index.xml" dir="sh3" filename="."/>
+      <tocentry page="Ports/sh3/index.xml" dir="sh3" filename=".">
+        <tocentry page="Ports/sh3/faq.xml" filename="faq.html"/>
+      </tocentry>     
       <tocentry page="Ports/shark/index.xml" dir="shark" filename="."/>
       <tocentry page="Ports/sparc/index.xml" dir="sparc" filename=".">
         <tocentry page="Ports/sparc/faq.xml" filename="faq.html"/>
Index: Ports/sh3/Makefile
===================================================================
RCS file: /cvsroot/htdocs/Ports/sh3/Makefile,v
retrieving revision 1.7
diff -u -r1.7 Makefile
--- Ports/sh3/Makefile	5 Nov 2005 16:04:16 -0000	1.7
+++ Ports/sh3/Makefile	6 Apr 2007 22:37:13 -0000
@@ -1,6 +1,6 @@
 #	$NetBSD: Makefile,v 1.7 2005/11/05 16:04:16 mishka Exp $
 
 XMLDOCS+=	index
-LISTDOCS+=	faq.list
+XMLDOCS+=	faq
 
 .include "../../share/mk/web.site.mk"
Index: Ports/sh3/faq.xml
===================================================================
RCS file: Ports/sh3/faq.xml
diff -N Ports/sh3/faq.xml
--- /dev/null	1 Jan 1970 00:00:00 -0000
+++ Ports/sh3/faq.xml	6 Apr 2007 22:37:13 -0000
@@ -0,0 +1,111 @@
+<?xml version="1.0"?>
+<!DOCTYPE webpage
+ PUBLIC "-//NetBSD//DTD Website-based NetBSD Extension//EN"
+        "http://www.NetBSD.org/share/xml/website-netbsd.dtd">
+
+<webpage id="Ports-sh3-faq">
+<config param="desc" value="NetBSD/sh3 Frequently Asked Questions"/>
+<config param="cvstag" value="$NetBSD$"/>
+<config param="rcsdate" value="$Date$"/>
+<head>
+
+<!-- Copyright (c) 1994-2007
+	The NetBSD Foundation, Inc.  ALL RIGHTS RESERVED. -->
+
+<title>NetBSD/sh3 Frequently Asked Questions</title>
+</head>
+
+<sect1 role="toc">
+<title>NetBSD/sh3 Frequently Asked Questions</title>
+
+<sect2 id="netbsd_questions">
+<title>NetBSD Questions</title>
+
+<sect3 id="crossbuild">
+<title>How can I start cross-builds?</title>
+<para>
+See <ulink url="../../Documentation/cross/">Cross-building NetBSD</ulink>
+for cross build in general.</para>
+<para>
+<filename role="pkg">cross/sh-netbsdcoff</filename> (for big endian)
+and <filename role="pkg">cross/shel-netbsdcoff</filename> (for little
+endian) should be good starting points.  Build script is provided in
+<ulink
+url="http://cvsweb.NetBSD.org/bsdweb.cgi/sys/arch/sh3/conf/build-sh3.el?rev=HEAD&amp;content-type=text/x-cvsweb-markup">sys/arch/sh3/conf/build-sh3.el</ulink>
+and <ulink
+url="http://cvsweb.NetBSD.org/bsdweb.cgi/sys/arch/sh3/conf/build-sh3.eb.?rev=HEAD&amp;content-type=text/x-cvsweb-markup">sys/arch/sh3/conf/build-sh3.eb.</ulink>
+At least you need to update <varname>MACHINEM</varname> and
+<varname>MACHINE_ARCH</varname> settings.</para>
+</sect3>
+</sect2>
+
+<sect2 id="hardware_questions">
+<title>Hardware Questions</title>
+
+<sect3 id="evalcard">
+<title>Are there evaluation cards available outside of Japan/with non-Japanese documents?</title>
+<para>
+We have <ulink url="./">listed couple of eval cards</ulink> we know of,
+if you have any additions, please submit those to the
+<email>port-sh3@NetBSD.org</email> mailing list.
+Unfortunately we have information for Japanese evaluation cards only.
+</para>
+<para>
+If you are outside of Japan, the best place you could contact is
+your local Hitachi office (like Hitachi US, Hitachi UK, whatever).
+They should have evaluation boards to sell to customers (since they would
+like to sell the SH3/4 chips), possibly with localized documents.
+</para>
+<para>
+Among Japanese products, mmEye and Dreamcast are available outside of Japan.
+</para>
+</sect3>
+</sect2>
+
+<sect2 id="readings">
+<title>Readings</title>
+
+<sect3 id="suggestreadings">
+<title>Suggested readings?</title>
+<variablelist>
+<varlistentry>
+<term>"Monthly Interface", CQ publishing, April 2000 issue (in Japanese)
+<ulink url="http://www.cqpub.co.jp/interface/contents/2000/200004.htm">(webpage)</ulink></term>
+<listitem>	Includes RT-Linux, Linux/sh3, NetBSD/sh3 and porting
+how-to.</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>"UNIX OS for embedded engineers", CQ publishing, July 2000 (in Japanese)
+<ulink url="http://www.cqpub.co.jp/hanbai/books/520070.htm">(webpage)</ulink></term>
+<listitem>	Includes RT-Linux, Linux/sh3, NetBSD/sh3 and porting
+how-to.</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>"implementation of embeded system on SEIL T1", BSD Magazine No.6, Dec. 2000
+(in Japanese)
+<ulink url="http://www.ascii.co.jp/BSDmag/200006/contents.html">(webpage)</ulink></term>
+<listitem>	Covers <ulink url="http://www.brains.co.jp/">Brains mmEye</ulink>
+	and <ulink url="http://www.iij.ad.jp/pressrelease/2000/seil-T1-e.html">
+	IIJ SEIL-T1</ulink> porting efforts.</listitem>
+</varlistentry>
+</variablelist>
+</sect3>
+</sect2>
+
+<sect2 id="other_info">
+<title>Other sources of information</title>
+<sect3 id="other_info_nbsd">
+<title>Other information at NetBSD.org</title>
+<itemizedlist>
+<listitem><para><email>port-sh3@NetBSD.org</email>
+    - if you have any additional questions please subscribe.</para></listitem>
+<listitem><para><ulink url="../../Documentation/">General NetBSD Documentation</ulink>
+    - for questions not specific to NetBSD/sh3.</para></listitem>
+</itemizedlist>
+</sect3>
+</sect2>
+</sect1>
+<parentsec url="./" text="NetBSD/sh3 ports page"/>
+</webpage>

--j+MD90OnwjQyWNYt--