need some help with my documentation

Collapse
X
 
  • Time
  • Show
Clear All
new posts
  • deltamami0999
    New Member
    • Feb 2008
    • 16

    need some help with my documentation

    can someone help me to document my code quickly?

    //Name: Cassi Smith
    //Date: March 5, 2008
    //Assignment: Chapter 12 Inventory Management System
    //Description: This header file makes available the functions that can be reused
    by the client and data fields t
    #include <string>
    using namespace std;
    class InventoryItem
    {

    public:
    InventoryItem() ;
    InventoryItem(d ouble UPC, string itemName, int quantity, double price);

    double getUPC();
    string getItemName();
    int getQuantity();
    double getPrice();

    void setUPC(double UPC);
    void setItemName(str ing itemName);
    void setQuantity(int quantity);
    void setPrice(double price);

    double getValueOfInven toryItem();
    void writeItem();

    private:
    double UPC;
    string itemName;
    int quantity;
    double price;

    };
  • gpraghuram
    Recognized Expert Top Contributor
    • Mar 2007
    • 1275

    #2
    Originally posted by deltamami0999
    can someone help me to document my code quickly?

    //Name: Cassi Smith
    //Date: March 5, 2008
    //Assignment: Chapter 12 Inventory Management System
    //Description: This header file makes available the functions that can be reused
    by the client and data fields t
    #include <string>
    using namespace std;
    class InventoryItem
    {

    public:
    InventoryItem() ;
    InventoryItem(d ouble UPC, string itemName, int quantity, double price);

    double getUPC();
    string getItemName();
    int getQuantity();
    double getPrice();

    void setUPC(double UPC);
    void setItemName(str ing itemName);
    void setQuantity(int quantity);
    void setPrice(double price);

    double getValueOfInven toryItem();
    void writeItem();

    private:
    double UPC;
    string itemName;
    int quantity;
    double price;

    };

    Try to use doxygen the open source tool to generate the documentation for your code
    raghuram

    Comment

    • deltamami0999
      New Member
      • Feb 2008
      • 16

      #3
      Originally posted by gpraghuram
      Try to use doxygen the open source tool to generate the documentation for your code
      raghuram
      what does that mean?

      Comment

      • MACKTEK
        New Member
        • Mar 2008
        • 40

        #4
        Use google, type in Doxygen, and read how to use it.

        Asking someone "is there a program that can assist me to document your work?" results in: use such and such program... for example Doxygen.

        Unless of course you really want someone to "document" your work for you, in that case, you are posting in the wrong forum.

        If you do not understand what it means to "document" your work, then the answer is: the // creates a comment that is ignored by a program. but allows you to read information about the program.

        // This is a program.
        // Written by (author's name)

        Code:
        #include <string>
        using namespace std;
        class InventoryItem		 // class definition -- documenting the class
        {
            
        public:
            InventoryItem();
        Last edited by MACKTEK; Mar 6 '08, 04:43 AM. Reason: further clarification

        Comment

        Working...