fedora core 6 1.2949 + vserver 2.2.0
[linux-2.6.git] / Documentation / DocBook / mtdnand.tmpl
index 435bb52..a8c8cce 100644 (file)
@@ -1,4 +1,6 @@
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V3.1//EN"[]>
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
+       "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" []>
 
 <book id="MTD-NAND-Guide">
  <bookinfo>
                for most of the implementations. These functions can be replaced by the
                board driver if neccecary. Those functions are called via pointers in the
                NAND chip description structure. The board driver can set the functions which
-               should be replaced by board dependend functions before calling nand_scan().
+               should be replaced by board dependent functions before calling nand_scan().
                If the function pointer is NULL on entry to nand_scan() then the pointer
                is set to the default function which is suitable for the detected chip type.
                </para></listitem>
                [REPLACEABLE]</para><para>
                Replaceable members hold hardware related functions which can be 
                provided by the board driver. The board driver can set the functions which
-               should be replaced by board dependend functions before calling nand_scan().
+               should be replaced by board dependent functions before calling nand_scan().
                If the function pointer is NULL on entry to nand_scan() then the pointer
                is set to the default function which is suitable for the detected chip type.
                </para></listitem>
        <title>Basic board driver</title>
        <para>
                For most boards it will be sufficient to provide just the
-               basic functions and fill out some really board dependend
+               basic functions and fill out some really board dependent
                members in the nand chip description structure.
-               See drivers/mtd/nand/skeleton for reference.
        </para>
        <sect1>
                <title>Basic defines</title>
@@ -187,9 +188,9 @@ static unsigned long baseaddr;
        <sect1>
                <title>Partition defines</title>
                <para>
-                       If you want to divide your device into parititions, then
-                       enable the configuration switch CONFIG_MTD_PARITIONS and define
-                       a paritioning scheme suitable to your board.
+                       If you want to divide your device into partitions, then
+                       enable the configuration switch CONFIG_MTD_PARTITIONS and define
+                       a partitioning scheme suitable to your board.
                </para>
                <programlisting>
 #define NUM_PARTITIONS 2
@@ -238,9 +239,9 @@ static void board_hwcontrol(struct mtd_info *mtd, int cmd)
        struct nand_chip *this = (struct nand_chip *) mtd->priv;
        switch(cmd){
                case NAND_CTL_SETCLE: this->IO_ADDR_W |= CLE_ADRR_BIT;  break;
-               case NAND_CTL_CLRCLE: this->IO_ADDR_W &= ~CLE_ADRR_BIT; break;
+               case NAND_CTL_CLRCLE: this->IO_ADDR_W &amp;= ~CLE_ADRR_BIT; break;
                case NAND_CTL_SETALE: this->IO_ADDR_W |= ALE_ADRR_BIT;  break;
-               case NAND_CTL_CLRALE: this->IO_ADDR_W &= ~ALE_ADRR_BIT; break;
+               case NAND_CTL_CLRALE: this->IO_ADDR_W &amp;= ~ALE_ADRR_BIT; break;
        }
 }
                </programlisting>
@@ -391,7 +392,7 @@ static void board_select_chip (struct mtd_info *mtd, int chip)
        /* Deselect all chips, set all nCE pins high */
        GPIO(BOARD_NAND_NCE) |= 0xff;   
        if (chip >= 0)
-               GPIO(BOARD_NAND_NCE) &= ~ (1 << chip);  
+               GPIO(BOARD_NAND_NCE) &amp;= ~ (1 &lt;&lt; chip);
 }
                </programlisting>
                <para>
@@ -405,8 +406,8 @@ static void board_select_chip (struct mtd_info *mtd, int chip)
        struct nand_chip *this = (struct nand_chip *) mtd->priv;
        
        /* Deselect all chips */
-       this->IO_ADDR_R &= ~BOARD_NAND_ADDR_MASK;
-       this->IO_ADDR_W &= ~BOARD_NAND_ADDR_MASK;
+       this->IO_ADDR_R &amp;= ~BOARD_NAND_ADDR_MASK;
+       this->IO_ADDR_W &amp;= ~BOARD_NAND_ADDR_MASK;
        switch (chip) {
        case 0:
                this->IO_ADDR_R |= BOARD_NAND_ADDR_CHIP0;
@@ -1293,7 +1294,9 @@ in this page</entry>
      </para>
 !Idrivers/mtd/nand/nand_base.c
 !Idrivers/mtd/nand/nand_bbt.c
-!Idrivers/mtd/nand/nand_ecc.c
+<!-- No internal functions for kernel-doc:
+X!Idrivers/mtd/nand/nand_ecc.c
+-->
   </chapter>
 
   <chapter id="credits">