Menu

Setting up a new GnuCOBOL project on Sourceforge. HELP

Anonymous
2021-07-26
2021-07-30
  • Gary Van Winkle

    Gary Van Winkle - 2021-07-27

    I'm working on a new project which is intended to use Sourceforge as a repository for COBOL source (complete) programs and subprograms. These files are tutorial in nature. The procedure is:

    1. Download my FREE source code;
    2. Compile the COBOL program;
    3. Run the program and, through a series of screens, learn some feature of GnuCOBOL.

    The screens will present code, the reason for it, and they will reference paragraphs in my source program. They will also reference the GnuCOBOL Programming Guide. I know there are dozens of videos out there which demonstrate a programming procedure, but I think they are dizzying exercises in following a pointer around a screen we can hardly read to begin with.

    So I need to know how to transfer source files and pdf's to my project. I also need to know about the Sourceforge standards for projects. I have a copy of the GNU License which I plan to include for download.

    And of course, how to set up the files for download to anyone who wishes to use them.
    It occurs to me that a guide probably exists. Where should I expect to find it?

     

    Last edit: Simon Sobisch 2021-07-28
    • Brian Tiffin

      Brian Tiffin - 2021-07-28

      My suggestion now-a-days, and when I get off my duff and redo this place; self-hosted Fossil.

      Fossil SCM is (in my opinion) now the preeminent Software Configuration Management system. Single binary, single database, command line, built-in web ready server, or simple 2 line CGI modes. The revision control is quite a bit simpler to use than Git, yet as powerful and production ready. Tcl/Tk and SQLite are both hosted as Fossil projects.

      The single binary also supports Community Management features, Wiki, Tickets, Forum, Chat, look and feel skins, embedded documentation (Markdown or Fossil Wiki input forms), PIKCHR editor (ala old school pic from the good old nROFF days). Too many features to list here really. Git import/export when needs be (along with Subversion).

      https://fossil-scm.org/

      If that doesn't float your boat, then SourceForge offers both Project and Developer webs.

      https://sourceforge.net/p/forge/documentation/Project%20Web%20and%20Developer%20Web/

      All user accounts marked as "part of the project" also get a developer web space (including an available Centos shell).

      https://sourceforge.net/p/forge/documentation/Developer%20Web%20Services/

      Those pages have links to all the goodies and help, File Management Services and whatnot. Any files uploaded to the htdocs subdir of the project web space will be available for anybody download, anytime from anywhere. Usage rules are pretty straight forward. SourceForge needs rights to copy (obviously) and you can use just about any licence you want. *Given the requirement that the forge needs rights to copy everything you add to the project or developer web space, so they can host all the things without someone suing them for infringement).

      You can even host servers if that happens to be the goal of the project, but you can't host them to serve off port 80 (I don't think). Unless you can pester someone with root permissions at sourceforge.net (which I find highly unlikely unless you were a super famous project akin to Apache). You can even host Fossil repositories, via CGI, and we even use a couple for demos within the GnuCOBOL project space. Someday there will be a COBOL Reserved Word fossil for public access to COBOL documentation. And maybe even a Try Now online cobc compiler button (as you can even host containers here). Someday, the mythical someday.

      More information on SourceForge features are available from the Apache Allura project (which is the free software base of the forge, which evolved from the GNU Savannah system). The base SourceForge code went non-free for a while, but is now back to free software, and Allura. Base code that is. SourceForge is not all free software. Mostly Python code, easy-ish to read and tweak). SourceForge is more than Allura though, with the global mirror systems, making SourceForge projects highly discoverable. I almost setup an Allura instance, but find Fossil far more appealing. Allura can take days to setup. Fossil takes mere minutes.

      https://allura.apache.org/

      We would have gone with GNU hosting on Savannah, but that is older code and lacks a lot of Community features, like Forums. Running a community through Bug Reports is a Github thing, and I find it less friendly, so we ended up on the Forge. Except for some bad years of previous owners getting greedy and playing monkey games with adware attached to popular project downloads, (a time that has passed and new owners are far more ethical), the Forge has been very good to us.

      But, I'd like to do a Fossil (or two) next. It'll allow us to self-host and be masters of our own domain, with a clear split between GNU free software ethics, GnuCOBOL itself, and lesser not-so-free options, allowing members to openly advertise goods and services. GnuCOBOL adjacent.

      Have good, make well,
      Blue

       

      Last edit: Brian Tiffin 2021-07-29
      • Gary Van Winkle

        Gary Van Winkle - 2021-07-30

        O.K., guys. I think, but I'm not sure, I'm better off finding another repository somewhere. 
        I had hopes of finding something simple, e.g.: 1. Go to http://www.yoohoooo.com; 2. Click on send-us-your-source-file; 3. Enter the path and file name.ext of the file on your PC; 4. Enter a description of the product; 5. Wait 4 hours and test the download button.
        All communications, critiques, complaints, suggestions, other nagging, and thankyews will be sent directly to your e-mail in-box. Enter your e-mail address here.
        No wonder I'm writing tutorials and documentation to help people get started programming their own PC's using a laptop at least. I don't expect anyone to write 16 pages of COBOL with their thumbs.
        Anyhow, have a nice Olympics and Hungarian Gran Prix weekend. 
        Gary VanWinkle.
        On Wednesday, July 28, 2021, 05:32:37 AM EDT, Brian Tiffin btiffin@users.sourceforge.net wrote:

        My suggestion now-a-days, and when I get off my duff and redo this place; self-hosted Fossil.

        Fossil SCM is (in my opinion) now the preeminent Software Configuration Management system. Single binary, single database, command line, built-in web ready server, or simple 2 line CGI modes. The revision control is quite a bit simpler to use than Git, yet as powerful and production ready. Tcl/Tk and SQLite are both hosted as Fossil projects.

        The single binary also supports Community Management features, Wiki, Tickets, Forum, Chat, look and feel skins, embedded documentation (Markdown or Fossil Wiki input forms), PIKCHR editor (ala old school pic from the good old nROFF days). Too many features to list here really. Git import/export when needs be (along with Subversion).

        https://fossil-scm.org/

        If that doesn't float your boat, then SourceForge offers both Project and Developer webs.

        https://sourceforge.net/p/forge/documentation/Project%20Web%20and%20Developer%20Web/

        All user accounts marked as "part of the project" also get a developer web space (including an available Centos shell).

        https://sourceforge.net/p/forge/documentation/Developer%20Web%20Services/

        Those pages have links to all the goodies and help, File Management Services and whatnot. Any files uploaded to the htdocs subdir of the project web space will be available for joe q user download, anytime from anywhere. Usage rules are pretty straight forward. SourceForge needs rights to copy (obviously) and you can use just about any licence you want. *Given the requirement that the forge needs rights to copy everything you add to the project or developer web space, so they can host all the things without someone suing them for infringement).

        You can even host servers if that happens to be the goal of the project, but you can't host them to serve off port 80 (I don't think). Unless you can pester someone with root permissions at sourceforge.net (which I find highly unlikely unless you were a super famous project akin to Apache). You can even host Fossil repositories, via CGI, and we even use a couple for demos within the GnuCOBOL project space. Someday where will be a COBOL Reserved Word fossil for public access to COBOL documentation. And maybe even a Try Now online cobc compiler button (as you can even host containers here). Someday, the mythical someday.

        More information on SourceForge features are available from the Apache Allura project (which is the free software base of the forge, which evolved from the GNU Savannah system). The base SourceForge code went non-free for a while, but is now back to free software, and Allura. Base code that is. SourceForge is not all free software. Mostly Python code, easy-ish to read and tweak). SourceForge is more than Allura though, with the global mirror systems, making SourceForge projects highly discoverable. I almost setup an Allura instance, but find Fossil far more appealing. Allura can take days to setup. Fossil takes mere minutes.

        https://allura.apache.org/

        We would have gone with GNU hosting on Savannah, but that is older code and lacks a lot of Community features, like Forums. Running a community through Bug Reports is a Github thing, and I find it less friendly, so we ended up on the Forge. Except for some bad years of previous owners getting greedy and playing monkey games with adware attached to popular project downloads, (a time that has passed and new owners are far more ethical), the Forge has been very good to us.

        But, I'd like to do a Fossil (or two) next. It'll allow us to self-host and be masters of our own domain, with a clear split between GNU free software ethics, GnuCOBOL itself, and lesser not-so-free options, allowing members to openly advertise goods and services. GnuCOBOL adjacent.

        Have good, make well,
        Blue

        Setting up a new GnuCOBOL project on Sourceforge. HELP

        Sent from sourceforge.net because you indicated interest in https://sourceforge.net/p/gnucobol/discussion/help/

        To unsubscribe from further messages, please visit https://sourceforge.net/auth/subscriptions/

         
        • Simon Sobisch

          Simon Sobisch - 2021-07-30

          One possible option that was also used before: just upload your code to the contrib board with a question to upload it to the GnuCOBOL contrib repo and it will be done if it matches the notes in the main README.
          You'd then get a notification for reported issues and if you subscribe to it also for discussions.

           
  • Simon Sobisch

    Simon Sobisch - 2021-07-28

    I guess all information you look for is in the Site Documentation, which is also linked on this website below.
    If you don't want to use SVN because that's what you are very familiar with, I'd suggest to not use SVN as GnuCOBOL and GnuCOBOL contrib does (it is likely that we'll move to a distributed version control system, most likely git, somedayTM - and also likely that this site mostly becomes a mirror; we won't abandon it, but encourage people to use the new site when that happens).
    And if you use Git then there are better options than SF, for example https://codeberg.org/ or https://notabug.org/ (usable without Javascript and in other places better in the FSF's evaluation than the former; but not as nice looking and less better to build a community).

    That said: If you want to use SVN+SF then you could have your contribution also be part of https://sourceforge.net/p/gnucobol/contrib/HEAD/tree/trunk/ - I think a subfolder "courses" or "tutorials" would be good (which would be the place for both your contribution and at least the worldcities "examples"). In this case "your procedure" would be mainly to use svn commit to "publish" your changes (I highly encourage to do this together with a ChangeLog), any users could "browse" and view the files online, download a single one or a snapshot of the complete package, or use svn to get an update; announcements and discussions about this would then go to https://sourceforge.net/p/gnucobol/discussion/contrib/ - What do you think?

     

Anonymous
Anonymous

Add attachments
Cancel