Rocksolid Light

Welcome to Rocksolid Light

mail  files  register  newsreader  groups  login

Message-ID:  

"If Diet Coke did not exist it would have been necessary to invent it." -- Karl Lehenbauer

computers / comp.sys.apple2 / Re: CiderPress Format Docs index

SubjectAuthor
* CiderPress Format Docs indexfadden
`* CiderPress Format Docs indexOliver Schmidt
 `- CiderPress Format Docs indexfadden

1
CiderPress Format Docs index

<cd095e52-d970-4be8-8522-fb0fe7e3a14en@googlegroups.com>

  copy mid

https://news.novabbs.org/computers/article-flat.php?id=5339&group=comp.sys.apple2#5339

  copy link   Newsgroups: comp.sys.apple2
X-Received: by 2002:a05:620a:1a9c:b0:757:6864:6d0 with SMTP id bl28-20020a05620a1a9c00b00757686406d0mr10010678qkb.4.1684169871016;
Mon, 15 May 2023 09:57:51 -0700 (PDT)
X-Received: by 2002:ac8:584d:0:b0:3e9:9419:b153 with SMTP id
h13-20020ac8584d000000b003e99419b153mr11768439qth.0.1684169870727; Mon, 15
May 2023 09:57:50 -0700 (PDT)
Path: i2pn2.org!i2pn.org!weretis.net!feeder6.news.weretis.net!news.misty.com!border-2.nntp.ord.giganews.com!nntp.giganews.com!news-out.google.com!nntp.google.com!postnews.google.com!google-groups.googlegroups.com!not-for-mail
Newsgroups: comp.sys.apple2
Date: Mon, 15 May 2023 09:57:50 -0700 (PDT)
Injection-Info: google-groups.googlegroups.com; posting-host=24.130.68.111; posting-account=UAtoeQoAAADrX7T-MHdWWRC4Fzf0dsLP
NNTP-Posting-Host: 24.130.68.111
User-Agent: G2/1.0
MIME-Version: 1.0
Message-ID: <cd095e52-d970-4be8-8522-fb0fe7e3a14en@googlegroups.com>
Subject: CiderPress Format Docs index
From: thefadden@gmail.com (fadden)
Injection-Date: Mon, 15 May 2023 16:57:51 +0000
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
Lines: 27
 by: fadden - Mon, 15 May 2023 16:57 UTC

One of the less-obvious aspects of the CiderPress II project is the inclusion of a significant amount of documentation. There's about 6500 lines of text documents in Markdown format (~110 pages if you printed it at 60 lines/page). While a lot of that is documentation for the application and its source code, much of it describes the formats of file archives, disk images, and file formats.

These started because, as I was writing the code to support the various things, I wanted "cheat sheets" so I didn't have to go running back to Beneath Apple ProDOS every time I needed to decipher a directory hex dump. Over time I added notes on the ways that "real world" files differ from the specification, as well as clarifications on various aspects (e.g. I'm somewhat obsessed with figuring out which character set to use).

In some cases these are very brief, in others (e.g. HFS) they go on at some length. They generally start with references to "authoritative" documents should you wish a more thorough explanation.

These files are scattered through the source tree, e.g. the ProDOS notes sit next to the ProDOS implementation. This is inconvenient, so I threw together an index here:

https://ciderpress2.com/doc-index.html

The page is just a collection of links to the documentation in the github repository. github does a pretty good job of formatting Markdown. And if you want to look at the associated code, you're already in the right place. :-)

Re: CiderPress Format Docs index

<u40uea$3lsf$1@solani.org>

  copy mid

https://news.novabbs.org/computers/article-flat.php?id=5340&group=comp.sys.apple2#5340

  copy link   Newsgroups: comp.sys.apple2
Path: i2pn2.org!i2pn.org!weretis.net!feeder8.news.weretis.net!reader5.news.weretis.net!news.solani.org!.POSTED!not-for-mail
From: ol.sc@web.de (Oliver Schmidt)
Newsgroups: comp.sys.apple2
Subject: Re: CiderPress Format Docs index
Date: Tue, 16 May 2023 22:00:42 -0000 (UTC)
Message-ID: <u40uea$3lsf$1@solani.org>
References: <cd095e52-d970-4be8-8522-fb0fe7e3a14en@googlegroups.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 8bit
Injection-Date: Tue, 16 May 2023 22:00:42 -0000 (UTC)
Injection-Info: solani.org;
logging-data="120719"; mail-complaints-to="abuse@news.solani.org"
User-Agent: NewsTap/5.5 (iPhone/iPod Touch)
Cancel-Lock: sha1:5dwYyahCPu0a6CVHSbmKArZHUH4= sha1:SesyQApcr6DRhABDddwN6JNW7W0=
X-User-ID: eJwVxskNwDAMA7CVLB9KOk4RW/uPkBb8sILgWclilj7eEa+CtiXVgD3LDYnRA4S2/TmiHJ24GokRAA==
 by: Oliver Schmidt - Tue, 16 May 2023 22:00 UTC

Hi,

> https://ciderpress2.com/doc-index.html

In
https://github.com/fadden/CiderPress2/blob/main/FileConv/Gfx/DoubleHiRes-notes.md#format
You write:

"The first half holds the main RAM portion, the second half holds the aux
RAM portion."

However from what I know, it's just the other around.

Regards,
Oliver

Re: CiderPress Format Docs index

<ac8f1fb7-1982-4264-adea-0ef7450f2245n@googlegroups.com>

  copy mid

https://news.novabbs.org/computers/article-flat.php?id=5341&group=comp.sys.apple2#5341

  copy link   Newsgroups: comp.sys.apple2
X-Received: by 2002:ad4:550e:0:b0:61b:738e:cd80 with SMTP id pz14-20020ad4550e000000b0061b738ecd80mr6693393qvb.7.1684275513788;
Tue, 16 May 2023 15:18:33 -0700 (PDT)
X-Received: by 2002:ac8:7c4d:0:b0:3df:4392:1aff with SMTP id
o13-20020ac87c4d000000b003df43921affmr13647594qtv.6.1684275513595; Tue, 16
May 2023 15:18:33 -0700 (PDT)
Path: i2pn2.org!i2pn.org!weretis.net!feeder6.news.weretis.net!usenet.blueworldhosting.com!diablo1.usenet.blueworldhosting.com!peer01.iad!feed-me.highwinds-media.com!news.highwinds-media.com!news-out.google.com!nntp.google.com!postnews.google.com!google-groups.googlegroups.com!not-for-mail
Newsgroups: comp.sys.apple2
Date: Tue, 16 May 2023 15:18:33 -0700 (PDT)
In-Reply-To: <u40uea$3lsf$1@solani.org>
Injection-Info: google-groups.googlegroups.com; posting-host=24.130.68.111; posting-account=UAtoeQoAAADrX7T-MHdWWRC4Fzf0dsLP
NNTP-Posting-Host: 24.130.68.111
References: <cd095e52-d970-4be8-8522-fb0fe7e3a14en@googlegroups.com> <u40uea$3lsf$1@solani.org>
User-Agent: G2/1.0
MIME-Version: 1.0
Message-ID: <ac8f1fb7-1982-4264-adea-0ef7450f2245n@googlegroups.com>
Subject: Re: CiderPress Format Docs index
From: thefadden@gmail.com (fadden)
Injection-Date: Tue, 16 May 2023 22:18:33 +0000
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
X-Received-Bytes: 1616
 by: fadden - Tue, 16 May 2023 22:18 UTC

On Tuesday, May 16, 2023 at 3:02:24 PM UTC-7, Oliver Schmidt wrote:
> "The first half holds the main RAM portion, the second half holds the aux
> RAM portion."
>
> However from what I know, it's just the other around.

The file type note for $08/0000 agrees with you. I've updated the doc. Thanks for pointing this out.

(I usually catch these things when writing the code, but I haven't written the DHR converter yet.)

1
server_pubkey.txt

rocksolid light 0.9.81
clearnet tor