Subject: [docathon] converted Ports/sh5/faq.list
To: None <netbsd-docs@netbsd.org>
From: None <dsieger@techfak.uni-bielefeld.de>
List: netbsd-docs
Date: 04/07/2007 01:09:20
--pWyiEgJYm5f9v55/
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline

Ports/sh5/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

--pWyiEgJYm5f9v55/
Content-Type: text/plain; charset=us-ascii
Content-Disposition: attachment; filename="sh5-faq.diff"

Index: layout.xml
===================================================================
RCS file: /cvsroot/htdocs/layout.xml,v
retrieving revision 1.246
diff -u -r1.246 layout.xml
--- layout.xml	6 Apr 2007 22:46:43 -0000	1.246
+++ layout.xml	6 Apr 2007 23:01:10 -0000
@@ -297,7 +298,10 @@
       <tocentry page="Ports/sgimips/index.xml" dir="sgimips" filename=".">
         <tocentry page="Ports/sgimips/faq.xml" filename="faq.html"/>
       </tocentry>
+      <tocentry page="Ports/sh5/faq.xml" dir="sh5" filename="faq.html"/>
       <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/sh5/Makefile
===================================================================
RCS file: /cvsroot/htdocs/Ports/sh5/Makefile,v
retrieving revision 1.3
diff -u -r1.3 Makefile
--- Ports/sh5/Makefile	14 Oct 2005 08:59:58 -0000	1.3
+++ Ports/sh5/Makefile	6 Apr 2007 23:01:10 -0000
@@ -1,5 +1,5 @@
 #	$NetBSD: Makefile,v 1.3 2005/10/14 08:59:58 rillig Exp $
 
-LISTDOCS+=	faq.list
+XMLDOCS+=	faq
 
 .include "../../share/mk/web.site.mk"
Index: Ports/sh5/faq.xml
===================================================================
RCS file: Ports/sh5/faq.xml
diff -N Ports/sh5/faq.xml
--- /dev/null	1 Jan 1970 00:00:00 -0000
+++ Ports/sh5/faq.xml	6 Apr 2007 23:01:10 -0000
@@ -0,0 +1,87 @@
+<?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=sh5-faq">
+<config param="desc" value="NetBSD/sh5 Frequently Asked Questions"/>
+<config param="cvstag" value="$NetBSD$"/>
+<config param="rcsdate" value="$Date$"/>
+<head>
+
+<!-- Copyright (c) 2002-2007
+	The NetBSD Foundation, Inc.  ALL RIGHTS RESERVED. -->
+
+<title>NetBSD/sh5 Frequently Asked Questions</title>
+</head>
+
+<sect1 role="toc">
+<title>NetBSD/sh5 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>
+Unfortunately, there is no generally available toolchain for building
+sh5 binaries at this time. The port was brought up using a heavilly
+modified port of gcc 2.97 by SuperH.</para>
+<para>
+Work is on-going in gcc-current to provide a usable and stable sh5
+compiler.</para>
+</sect3>
+</sect2>
+
+<sect2 id="hardware_questions">
+<title>Hardware Questions</title>
+
+<sect3 id="evalcard">
+<title>Are there evaluation cards available for the SH-5?</title>
+<para>
+We are only aware of SuperH's Cayman board at this time.
+If you have any additions, please submit those to the
+<ulink url="../../MailingLists/#port-sh5">port-sh5</ulink> mailing list.</para>
+<para>
+The best place you could contact is
+your local SuperH office (like SuperH US, SuperH UK, whatever).
+They may have evaluation boards to sell to customers (since they would
+like to sell the SH5 chips), possibly with localized documents.</para>
+</sect3>
+</sect2>
+
+<sect2 id="readings">
+<title>Readings</title>
+
+<sect3 id="suggestreadings">
+<title>Suggested readings?</title>
+<variablelist>
+<varlistentry>
+<term>SH-5 Documentation
+<ulink url="http://www.superh-software.com/docs.php">(webpage)</ulink></term>
+<listitem><para>Covers the SH-5 cpu family core architecture, the implementation
+	of current silicon, the on-chip peripherals, and the high-level
+	programming language ABI.</para></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-sh5@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/sh5 ports page"/>
+</webpage>

--pWyiEgJYm5f9v55/--