How do I create an MCZ file?

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
6 messages Options
Reply | Threaded
Open this post in threaded view
|

How do I create an MCZ file?

JohnReed Maffeo
I have been looking all over and I can not find the instructions about how to create an MCZ file. I have a working version of the program I have been developing and would like to start using SS3 as a repository, but it will only let me upload an MCZ file. All I seem to be able to find is file out in the Category pane.

Thanks,

john-reed

Reply | Threaded
Open this post in threaded view
|

Re: How do I create an MCZ file?

Casey Ransberger-2

> On Feb 28, 2014, at 4:49 PM, "JohnReed Maffeo" <[hidden email]> wrote:
>
> I have been looking all over and I can not find the instructions about how to create an MCZ file. I have a working version of the program I have been developing and would like to start using SS3 as a repository, but it will only let me upload an MCZ file. All I seem to be able to find is file out in the Category pane.
>
> Thanks,
>
> john-reed

Hi John. Have you looked at the Monticello browser? It's in the open... menu IIRC. I haven't used it in a while as I've been spending a lot of time in Cuis, but basically it's a SCM tool. It creates and loads .mcz files.

I think Wiresong had a tutorial on the web somewhere. You might start by googling that.

Hope this helps,

Casey
Reply | Threaded
Open this post in threaded view
|

Re: How do I create an MCZ file?

Frank Shearar-3
On 28 February 2014 17:08, Casey Ransberger <[hidden email]> wrote:

>
>> On Feb 28, 2014, at 4:49 PM, "JohnReed Maffeo" <[hidden email]> wrote:
>>
>> I have been looking all over and I can not find the instructions about how to create an MCZ file. I have a working version of the program I have been developing and would like to start using SS3 as a repository, but it will only let me upload an MCZ file. All I seem to be able to find is file out in the Category pane.
>>
>> Thanks,
>>
>> john-reed
>
> Hi John. Have you looked at the Monticello browser? It's in the open... menu IIRC. I haven't used it in a while as I've been spending a lot of time in Cuis, but basically it's a SCM tool. It creates and loads .mcz files.

Also available under the Tools menu at the top of the window.

Once open, your package should appear in the left pane. (This is the
name of the system category, typically, or the prefix of the system
categories if you have Foo-Core, Foo-Test, Foo-Extra categories. If
it's not there, hit the +Package button, which will prompt you for a
name.

It's probaby a good idea to add a package for every system category
you have. So given system categories Foo-Core and Foo-Test, make
packages with those same names. Once that's done, click any of your
packages and add a repository to it by clicking the "+Repository"
button. You'll want an HTTP repository, and you'll put the relevant
description there:

MCHttpRepository
location: 'http://ss3.gemstone.com/ss/Foo'
user: 'yourname'
password: 'yourpassword'

Right click (er, blue click? I have no idea) that repository and
select "add to package..." to add the repository to your other
packages.

Once you've done all of that, you can select each package when you're
done editing, select the repository, and hit "Save". It should be
obvious what to do after that. Note that you will end up with a local
copy of the mcz in your package-cache. If something goes wrong in the
save process, you can often open up the package-cache repository,
select the relevant package and version, and use the Copy button to
copy it to another repository. Be careful, because that list of target
repositories includes _all_ known repositories, not just the ones you
added to your packages in the Monticello Browser.

frank

> I think Wiresong had a tutorial on the web somewhere. You might start by googling that.
>
> Hope this helps,
>
> Casey

Reply | Threaded
Open this post in threaded view
|

Re: How do I create an MCZ file?

Levente Uzonyi-2
In reply to this post by JohnReed Maffeo
On Fri, 28 Feb 2014, JohnReed Maffeo wrote:

> I have been looking all over and I can not find the instructions about how to create an MCZ file. I have a working version of the program I have been developing and would like to start using SS3 as a repository, but it will only let me upload an MCZ file. All I seem to be able to find is file out in the Category pane.

"Creating a Working Copy From scratch

Click on the "+Package" button, and enter the name of a PackageInfo
package. It doesn"t matter whether or not the code for the package already
exists. Once the Working Copy has been created, the name of the package
will appear in the package list on the left side of the Monticello
Browser. If you loaded an existing version, the version name will be
displayed in parenthesis after the package name, otherwise the parenthesis
will be empty, indicating that your working copy has no ancestors.

Saving Changes

Changes to your working copy are automatically logged in your changes
file, so you only need to create a new version of your package when you
want to share the changes with others. Select the package on the left side
of the Monticello Browser and the repository to save to on the right, then
click the 'Save' button. See Repositories for discussion of how to publish
to shared repositories." - From http://www.wiresong.ca/monticello/v1/docs/getting-started.html

You might also find these links useful:
https://www.hpi.uni-potsdam.de/hirschfeld/trac/SqueakCommunityProjects/wiki/squeak_screencasts#VersioningyourworkwithMonticello
http://www.wiresong.ca/monticello/v1/docs/package-info.html
http://www.wiresong.ca/monticello/v1/docs/


Levente

>
> Thanks,
>
> john-reed
>
>

Reply | Threaded
Open this post in threaded view
|

Re: How do I create an MCZ file?

JohnReed Maffeo
In reply to this post by JohnReed Maffeo
 ----- Original Message -----

> From: Levente Uzonyi
> Sent: 02/28/14 08:20 PM
> To: The general-purpose Squeak developers list
> Subject: Re: [squeak-dev] How do I create an MCZ file?
>
> On Fri, 28 Feb 2014, JohnReed Maffeo wrote:
>
> > I have been looking all over and I can not find the instructions about how to create an MCZ file. I have a working version of the program I have been developing and would like to start using SS3 as a repository, but it will only let me upload an MCZ file. All I seem to be able to find is file out in the Category pane.
>
> "Creating a Working Copy From scratch
>
> Click on the "+Package" button, and enter the name of a PackageInfo
> package. It doesn"t matter whether or not the code for the package already
> exists. Once the Working Copy has been created, the name of the package
> will appear in the package list on the left side of the Monticello
> Browser. If you loaded an existing version, the version name will be
> displayed in parenthesis after the package name, otherwise the parenthesis
> will be empty, indicating that your working copy has no ancestors.
>
> Saving Changes
>
> Changes to your working copy are automatically logged in your changes
> file, so you only need to create a new version of your package when you
> want to share the changes with others.

>Select the package on the left side
> of the Monticello Browser and the repository to save to on the right, then
> click the 'Save' button.

Thanks! This is where I got stuck. I did read a lot of documetation and code yesterday, but I never quited made the connection of selecting the two objects and clicking the 'Save' button.

I guess I was blinded by my assumptions. The SS3 web site offers me the opportunity to upload a file, but it has to be in MCZ format. My expectation was that there should be a popup menu item similar to #fileOut somewhere and I just couldn't find it.

Now that I see how the file is created, I understand the Monticello philosophy better. I can use my local repository for day-to-day development and publish periodic point releases to an external, shared repositiory.

My next challenge will be to learn more about refactoring.


Reply | Threaded
Open this post in threaded view
|

Re: How do I create an MCZ file?

Eliot Miranda-2
Hi JohnReed,


On Sat, Mar 1, 2014 at 8:02 AM, JohnReed Maffeo <[hidden email]> wrote:
 ----- Original Message -----
> From: Levente Uzonyi
> Sent: 02/28/14 08:20 PM
> To: The general-purpose Squeak developers list
> Subject: Re: [squeak-dev] How do I create an MCZ file?
>
> On Fri, 28 Feb 2014, JohnReed Maffeo wrote:
>
> > I have been looking all over and I can not find the instructions about how to create an MCZ file. I have a working version of the program I have been developing and would like to start using SS3 as a repository, but it will only let me upload an MCZ file. All I seem to be able to find is file out in the Category pane.
>
> "Creating a Working Copy From scratch
>
> Click on the "+Package" button, and enter the name of a PackageInfo
> package. It doesn"t matter whether or not the code for the package already
> exists. Once the Working Copy has been created, the name of the package
> will appear in the package list on the left side of the Monticello
> Browser. If you loaded an existing version, the version name will be
> displayed in parenthesis after the package name, otherwise the parenthesis
> will be empty, indicating that your working copy has no ancestors.
>
> Saving Changes
>
> Changes to your working copy are automatically logged in your changes
> file, so you only need to create a new version of your package when you
> want to share the changes with others.

>Select the package on the left side
> of the Monticello Browser and the repository to save to on the right, then
> click the 'Save' button.

Thanks! This is where I got stuck. I did read a lot of documetation and code yesterday, but I never quited made the connection of selecting the two objects and clicking the 'Save' button.

I guess I was blinded by my assumptions. The SS3 web site offers me the opportunity to upload a file, but it has to be in MCZ format. My expectation was that there should be a popup menu item similar to #fileOut somewhere and I just couldn't find it.

Now that I see how the file is created, I understand the Monticello philosophy better. I can use my local repository for day-to-day development and publish periodic point releases to an external, shared repositiory.

I recommend that you publish as often as possible to the external shared repository.  It is very useful to be able to get the diffs between specific versions.  The way I see the package-cache is that it gives me a simple way of continuing to work when I don't have network connectivity (I'm on the move, or the repository isn't responding).

My next challenge will be to learn more about refactoring.

Enjoy! 
 
>See Repositories for discussion of how to publish
> to shared repositories." - From http://www.wiresong.ca/monticello/v1/docs/getting-started.html
>
> You might also find these links useful:
> https://www.hpi.uni-potsdam.de/hirschfeld/trac/SqueakCommunityProjects/wiki/squeak_screencasts#VersioningyourworkwithMonticello
> http://www.wiresong.ca/monticello/v1/docs/package-info.html
> http://www.wiresong.ca/monticello/v1/docs/
>
>
> Levente
>
> >
> > Thanks,
> >
> > john-reed
> >
> >





--
best,
Eliot