diff -r 000000000000 -r 42188c7ea2d9 Orb/Doxygen/src/docsets.cpp
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Orb/Doxygen/src/docsets.cpp	Thu Jan 21 17:29:01 2010 +0000
@@ -0,0 +1,461 @@
+/******************************************************************************
+ *
+ * Copyright (C) 1997-2008 by Dimitri van Heesch.
+ *
+ * Permission to use, copy, modify, and distribute this software and its
+ * documentation under the terms of the GNU General Public License is hereby 
+ * granted. No representations are made about the suitability of this software 
+ * for any purpose. It is provided "as is" without express or implied warranty.
+ * See the GNU General Public License for more details.
+ *
+ * Documents produced by Doxygen are derivative works derived from the
+ * input used in their production; they are not affected by this license.
+ *
+ */
+
+#include "docsets.h"
+#include "config.h"
+#include "message.h"
+#include "doxygen.h"
+#include <qfile.h>
+
+
+DocSets::DocSets() : m_nodes(17), m_scopes(17)
+{
+  m_nf = 0;
+  m_tf = 0;
+  m_dc = 0;
+  m_id = 0;
+  m_nodes.setAutoDelete(TRUE);
+}
+
+DocSets::~DocSets()
+{
+  delete m_nf;
+  delete m_tf;
+}
+
+void DocSets::initialize()
+{
+  // -- get config options
+  QCString projectName = Config_getString("PROJECT_NAME");
+  if (projectName.isEmpty()) projectName="root";
+  QCString bundleId = Config_getString("DOCSET_BUNDLE_ID");
+  if (bundleId.isEmpty()) bundleId="org.doxygen.Project";
+  QCString feedName = Config_getString("DOCSET_FEEDNAME");
+  if (feedName.isEmpty()) feedName="FeedName";
+
+  // -- write Makefile
+  {
+  QCString mfName = Config_getString("HTML_OUTPUT") + "/Makefile";
+  QFile makefile(mfName);
+  if (!makefile.open(IO_WriteOnly))
+  {
+    err("Could not open file %s for writing\n",mfName.data());
+    exit(1);
+  }
+  QTextStream ts(&makefile);
+  ts.setEncoding(QTextStream::UnicodeUTF8);
+
+  ts << "DOCSET_NAME=" << bundleId << ".docset\n" 
+        "DOCSET_CONTENTS=$(DOCSET_NAME)/Contents\n"
+        "DOCSET_RESOURCES=$(DOCSET_CONTENTS)/Resources\n"
+        "DOCSET_DOCUMENTS=$(DOCSET_RESOURCES)/Documents\n"
+        "DESTDIR=~/Library/Developer/Shared/Documentation/DocSets\n"
+        "XCODE_INSTALL=$(shell xcode-select -print-path)\n"
+        "\n"
+        "all: docset\n"
+        "\n"
+        "docset:\n"
+        "\tmkdir -p $(DOCSET_DOCUMENTS)\n"
+        "\tcp Nodes.xml $(DOCSET_RESOURCES)\n"
+        "\tcp Tokens.xml $(DOCSET_RESOURCES)\n"
+        "\tcp Info.plist $(DOCSET_CONTENTS)\n"
+        "\ttar --exclude $(DOCSET_NAME) \\\n"
+        "\t    --exclude Nodes.xml \\\n"
+        "\t    --exclude Tokens.xml \\\n"
+        "\t    --exclude Info.plist \\\n"
+        "\t    --exclude Makefile -c -f - . \\\n"
+        "\t    | (cd $(DOCSET_DOCUMENTS); tar xvf -)\n"
+        "\t$(XCODE_INSTALL)/usr/bin/docsetutil index $(DOCSET_NAME)\n"
+        "\trm -f $(DOCSET_DOCUMENTS)/Nodes.xml\n"
+        "\trm -f $(DOCSET_DOCUMENTS)/Info.plist\n"
+        "\trm -f $(DOCSET_DOCUMENTS)/Makefile\n"
+        "\trm -f $(DOCSET_RESOURCES)/Nodes.xml\n"
+        "\trm -f $(DOCSET_RESOURCES)/Tokens.xml\n"
+        "\n"
+        "install: docset\n"
+        "\tmkdir -p $(DESTDIR)\n"
+        "\tcp -R $(DOCSET_NAME) $(DESTDIR)\n"
+        "\n"
+        "uninstall:\n"
+        "\trm -rf $(DESTDIR)/$(DOCSET_NAME)\n"
+        "\n"
+        "always:\n";
+  }
+
+  // -- write Info.plist
+  {
+  QCString plName = Config_getString("HTML_OUTPUT") + "/Info.plist";
+  QFile plist(plName);
+  if (!plist.open(IO_WriteOnly))
+  {
+    err("Could not open file %s for writing\n",plName.data());
+    exit(1);
+  }
+  QTextStream ts(&plist);
+  ts.setEncoding(QTextStream::UnicodeUTF8);
+
+  ts << "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" 
+        "<!DOCTYPE plist PUBLIC \"-//Apple Computer//DTD PLIST 1.0//EN\"\n" 
+        "\"http://www.apple.com/DTDs/PropertyList-1.0.dtd\">\n" 
+        "<plist version=\"1.0\">\n" 
+        "<dict>\n" 
+        "     <key>CFBundleName</key>\n" 
+        "     <string>" << projectName << "</string>\n" 
+        "     <key>CFBundleIdentifier</key>\n"
+        "     <string>" << bundleId << ".docset</string>\n" 
+        "     <key>DocSetFeedName</key>\n" 
+        "     <string>" << feedName << "</string>\n"
+        "</dict>\n"
+        "</plist>\n";
+  }
+
+  // -- start Nodes.xml
+  QCString notes = Config_getString("HTML_OUTPUT") + "/Nodes.xml";
+  m_nf = new QFile(notes);
+  if (!m_nf->open(IO_WriteOnly))
+  {
+    err("Could not open file %s for writing\n",notes.data());
+    exit(1);
+  }
+  QCString indexName=Config_getBool("GENERATE_TREEVIEW")?"main":"index";
+  m_nts.setDevice(m_nf);
+  m_nts.setEncoding(QTextStream::UnicodeUTF8);
+  m_nts << "<?xml version=\"1.0\" encoding=\"UTF-8\"?>" << endl;
+  m_nts << "<DocSetNodes version=\"1.0\">" << endl;
+  m_nts << "  <TOC>" << endl;
+  m_nts << "    <Node>" << endl;
+  m_nts << "      <Name>Root</Name>" << endl;
+  m_nts << "      <Path>" << indexName << Doxygen::htmlFileExtension << "</Path>" << endl;
+  m_nts << "      <Subnodes>" << endl;
+  m_dc = 1;
+  m_firstNode.resize(m_dc);
+  m_firstNode.at(0)=TRUE;
+
+  QCString tokens = Config_getString("HTML_OUTPUT") + "/Tokens.xml";
+  m_tf = new QFile(tokens);
+  if (!m_tf->open(IO_WriteOnly))
+  {
+    err("Could not open file %s for writing\n",tokens.data());
+    exit(1);
+  }
+  m_tts.setDevice(m_tf);
+  m_tts.setEncoding(QTextStream::UnicodeUTF8);
+  m_tts << "<?xml version=\"1.0\" encoding=\"UTF-8\"?>" << endl;
+  m_tts << "<Tokens version=\"1.0\">" << endl;
+}
+
+void DocSets::finalize()
+{
+  m_nts << indent() << " </Node>" << endl;
+  m_dc--;
+  m_nts << "      </Subnodes>" << endl;
+  m_nts << "    </Node>" << endl;
+  m_nts << "  </TOC>" << endl;
+  m_nts << "</DocSetNodes>" << endl;
+  m_nf->close();
+  delete m_nf;
+  m_nf=0;
+
+  m_tts << "</Tokens>" << endl;
+  m_tf->close();
+  delete m_tf;
+  m_tf=0;
+}
+
+QCString DocSets::indent()
+{
+  QCString result;
+  result.fill(' ',(m_dc+2)*2);
+  return result;
+}
+
+void DocSets::incContentsDepth()
+{
+  ++m_dc;
+  m_nts << indent() << "<Subnodes>" << endl;
+  m_firstNode.resize(m_dc);
+  if (m_dc>0)
+  {
+    m_firstNode.at(m_dc-1)=TRUE;
+  }
+}
+
+void DocSets::decContentsDepth()
+{
+  if (!m_firstNode.at(m_dc-1))
+  {
+    m_nts << indent() << " </Node>" << endl;
+  }
+  m_nts << indent() << "</Subnodes>" << endl;
+  --m_dc;
+}
+
+void DocSets::addContentsItem(bool isDir,
+                              const char *name, 
+                              const char *ref, 
+                              const char *file,
+                              const char *anchor)
+{
+  (void)isDir;
+  if (file && ref==0)
+  {
+    if (!m_firstNode.at(m_dc-1))
+    {
+      m_nts << indent() << " </Node>" << endl;
+    }
+    m_firstNode.at(m_dc-1)=FALSE;
+    m_nts << indent() << " <Node>" << endl;
+    m_nts << indent() << "  <Name>" << convertToXML(name) << "</Name>" << endl;
+    m_nts << indent() << "  <Path>" << file << Doxygen::htmlFileExtension;
+    if (anchor)
+    {
+      m_nts << "#" << anchor;
+    }
+    m_nts << "</Path>" << endl;
+  }
+}
+
+void DocSets::addIndexItem(Definition *context,MemberDef *md,
+                           const char *anchor,const char *word)
+{
+  (void)anchor;
+  (void)word;
+  if (md==0 || context==0) return; // TODO: also index non members...
+
+  FileDef *fd      = 0;
+  ClassDef *cd     = 0;
+  NamespaceDef *nd = 0;
+
+  if (md)
+  {
+    fd = md->getFileDef();
+    cd = md->getClassDef();
+    nd = md->getNamespaceDef();
+    if (!md->isLinkable()) return; // internal symbol
+  }
+
+  QCString scope;
+  QCString type;
+  QCString decl;
+
+  // determine language
+  QCString lang;
+  SrcLangExt langExt = SrcLangExt_Cpp;
+  if (fd) langExt = getLanguageFromFileName(fd->name());
+  switch (langExt)
+  {
+    case SrcLangExt_Cpp:
+    case SrcLangExt_ObjC:
+      {
+        if (md && (md->isObjCMethod() || md->isObjCProperty()))
+          lang="occ";  // Objective C/C++
+        else if (fd && fd->name().right(2).lower()==".c") 
+          lang="c";    // Plain C
+        else if (cd==0 && nd==0)
+          lang="c";    // Plain C symbol outside any class or namespace
+        else
+          lang="cpp";  // C++
+      }
+      break;
+    case SrcLangExt_IDL:    lang="idl"; break;        // IDL
+    case SrcLangExt_CSharp: lang="csharp"; break;     // C#
+    case SrcLangExt_PHP:    lang="php"; break;        // PHP4/5
+    case SrcLangExt_D:      lang="d"; break;          // D
+    case SrcLangExt_Java:   lang="java"; break;       // Java
+    case SrcLangExt_JS:     lang="javascript"; break; // Javascript
+    case SrcLangExt_Python: lang="python"; break;     // Python
+    case SrcLangExt_F90:    lang="fortran"; break;    // Fortran
+    case SrcLangExt_VHDL:   lang="vhdl"; break;       // VHDL
+    case SrcLangExt_XML:    lang="xml"; break;        // DBUS XML
+  }
+
+  if (md)
+  {
+    if (!md->isLinkable()) return; // internal symbol
+    if (context==0)
+    {
+      if (md->getGroupDef())
+        context = md->getGroupDef();
+      else if (md->getFileDef())
+        context = md->getFileDef();
+      if (context==0) return; // should not happen
+
+      switch (md->memberType())
+      {
+        case MemberDef::Define:
+          type="macro"; break;
+        case MemberDef::Function:
+          if (cd && (cd->compoundType()==ClassDef::Interface ||
+                     cd->compoundType()==ClassDef::Class))
+          {
+            if (md->isStatic())
+              type="clm";         // class member
+            else
+              type="instm";       // instance member
+          }
+          else if (cd && cd->compoundType()==ClassDef::Protocol)
+          {
+            if (md->isStatic())
+              type="intfcm";     // interface class member
+            else
+              type="intfm";      // interface member
+          }
+          else
+            type="func";
+          break;
+        case MemberDef::Variable:
+          type="data"; break;
+        case MemberDef::Typedef:
+          type="tdef"; break;
+        case MemberDef::Enumeration:
+          type="enum"; break;
+        case MemberDef::EnumValue:
+          type="econst"; break;
+          //case MemberDef::Prototype:
+          //  type="prototype"; break;
+        case MemberDef::Signal:
+          type="signal"; break;
+        case MemberDef::Slot:
+          type="slot"; break;
+        case MemberDef::Friend:
+          type="ffunc"; break;
+        case MemberDef::DCOP:
+          type="dcop"; break;
+        case MemberDef::Property:
+          if (cd && cd->compoundType()==ClassDef::Protocol) 
+            type="intfp";         // interface property
+          else 
+            type="instp";         // instance property
+          break;
+        case MemberDef::Event:
+          type="event"; break;
+      }
+      writeToken(m_tts,md,type,lang,scope,md->anchor());
+    }
+  }
+  else if (context && context->isLinkable())
+  {
+    if (fd==0 && context->definitionType()==Definition::TypeFile)
+    {
+      fd = (FileDef*)context;
+    }
+    if (cd==0 && context->definitionType()==Definition::TypeClass)
+    {
+      cd = (ClassDef*)context;
+    }
+    if (nd==0 && context->definitionType()==Definition::TypeNamespace)
+    {
+      nd = (NamespaceDef*)context;
+    }
+    if (fd)
+    {
+      type="file";
+    }
+    else if (cd) 
+    {
+      scope = cd->qualifiedName();
+      if (cd->isTemplate())
+      {
+        type="tmplt";
+      }
+      else if (cd->compoundType()==ClassDef::Protocol) 
+      {
+        type="intf";
+        if (scope.right(2)=="-p") scope=scope.left(scope.length()-2);
+      }
+      else if (cd->compoundType()==ClassDef::Interface)
+      {
+        type="cl";
+      }
+      else if (cd->compoundType()==ClassDef::Category)
+      {
+        type="cat";
+      }
+      else 
+      {
+        type = "cl";
+      }
+      IncludeInfo *ii = cd->includeInfo();
+      if (ii)
+      {
+        decl=ii->includeName;
+        if (decl.isEmpty())
+        {
+          decl=ii->local;
+        }
+      }
+    }
+    else if (nd)
+    {
+      scope = nd->name();
+      type = "ns";
+    }
+    if (m_scopes.find(context->getOutputFileBase())==0)
+    {
+      writeToken(m_tts,context,type,lang,0,0,decl);
+      m_scopes.append(context->getOutputFileBase(),(void*)0x8);
+    }
+  }
+}
+
+void DocSets::writeToken(QTextStream &t,
+                         const Definition *d,
+                         const QCString &type,
+                         const QCString &lang,
+                         const char *scope,
+                         const char *anchor,
+                         const char *decl)
+{
+  t << "  <Token>" << endl;
+  t << "    <TokenIdentifier>" << endl;
+  QString name = d->name();
+  if (name.right(2)=="-p")  name=name.left(name.length()-2);
+  t << "      <Name>" << convertToXML(name) << "</Name>" << endl;
+  if (!lang.isEmpty())
+  {
+    t << "      <APILanguage>" << lang << "</APILanguage>" << endl;
+  }
+  if (!type.isEmpty())
+  {
+    t << "      <Type>" << type << "</Type>" << endl;
+  }
+  if (scope)
+  {
+    t << "      <Scope>" << convertToXML(scope) << "</Scope>" << endl;
+  }
+  t << "    </TokenIdentifier>" << endl;
+  t << "    <Path>" << d->getOutputFileBase() 
+                    << Doxygen::htmlFileExtension << "</Path>" << endl;
+  if (anchor)
+  {
+    t << "    <Anchor>" << anchor << "</Anchor>" << endl;
+  }
+  QCString tooltip = d->briefDescriptionAsTooltip();
+  if (!tooltip.isEmpty())
+  {
+    t << "    <Abstract>" << convertToXML(tooltip) << "</Abstract>" << endl;
+  }
+  if (decl)
+  {
+    t << "    <DeclaredIn>" << convertToXML(decl) << "</DeclaredIn>" << endl;
+  }
+  t << "  </Token>" << endl;
+}
+
+void DocSets::addIndexFile(const char *name)
+{
+  (void)name;
+}
+