Documentation for Linux Development


(Steven Harms) #1

Hi,

I've been playing with Swift in Linux contexts, but I was wondering, how is
one meant to consult reference work?

The Swift language book is written in iBooks...so I don't have access to
that in Linux. I'd love for there to be a PDF equivalent that I could leave
on the Linux environment to work with.

Alternatively, is there a rich HTML download of the API? I'm used to Perl
and Ruby which shipped rich HTML pages that allowed you to research the API
sans network connection.

I hate to think an IDE is required to use a language e.g. XCode. Surely we
should be able to code without an IDE's completion. I may be tempting the
nursing home by thinking vim and good docs should cut it :blush:.

Thanks,

Steven


(Jon Shier) #2

http://swiftdoc.org <http://swiftdoc.org/> is a good online reference, though not always completely up to date (just mostly).

Jon

ยทยทยท

On Dec 18, 2016, at 9:44 PM, Steven Harms via swift-users <swift-users@swift.org> wrote:

Hi,

I've been playing with Swift in Linux contexts, but I was wondering, how is one meant to consult reference work?

The Swift language book is written in iBooks...so I don't have access to that in Linux. I'd love for there to be a PDF equivalent that I could leave on the Linux environment to work with.

Alternatively, is there a rich HTML download of the API? I'm used to Perl and Ruby which shipped rich HTML pages that allowed you to research the API sans network connection.

I hate to think an IDE is required to use a language e.g. XCode. Surely we should be able to code without an IDE's completion. I may be tempting the nursing home by thinking vim and good docs should cut it :blush:.

Thanks,

Steven

_______________________________________________
swift-users mailing list
swift-users@swift.org
https://lists.swift.org/mailman/listinfo/swift-users


(Jack Lawrence) #3

Hi Steven,

The Swift book is also available on the web here: https://developer.apple.com/library/content/documentation/Swift/Conceptual/Swift_Programming_Language/

The reference for the swift standard library is available on the web here: https://developer.apple.com/reference/swift

We don't currently ship offline copies of the documentation outside of Xcode.

Jack

ยทยทยท

On Dec 18, 2016, at 10:46 PM, Jon Shier via swift-users <swift-users@swift.org> wrote:

http://swiftdoc.org is a good online reference, though not always completely up to date (just mostly).

Jon

On Dec 18, 2016, at 9:44 PM, Steven Harms via swift-users <swift-users@swift.org> wrote:

Hi,

I've been playing with Swift in Linux contexts, but I was wondering, how is one meant to consult reference work?

The Swift language book is written in iBooks...so I don't have access to that in Linux. I'd love for there to be a PDF equivalent that I could leave on the Linux environment to work with.

Alternatively, is there a rich HTML download of the API? I'm used to Perl and Ruby which shipped rich HTML pages that allowed you to research the API sans network connection.

I hate to think an IDE is required to use a language e.g. XCode. Surely we should be able to code without an IDE's completion. I may be tempting the nursing home by thinking vim and good docs should cut it :blush:.

Thanks,

Steven

_______________________________________________
swift-users mailing list
swift-users@swift.org
https://lists.swift.org/mailman/listinfo/swift-users

_______________________________________________
swift-users mailing list
swift-users@swift.org
https://lists.swift.org/mailman/listinfo/swift-users


(Steven Harms) #4

Jack,

Thanks for the reply. It's genuinely appreciated.

Is there any constructive action the community can take to promote that
these knowledge assets be made as "open source" as the language that
implements their ideas?

Thanks for the helpful suggestions,

Steven

ยทยทยท

On Mon, Dec 19, 2016 at 1:03 AM, Jack Lawrence <jackl@apple.com> wrote:

Hi Steven,

The Swift book is also available on the web here: https://developer.apple.
com/library/content/documentation/Swift/Conceptual/Swift_Programming_
Language/

The reference for the swift standard library is available on the web here:
https://developer.apple.com/reference/swift

We don't currently ship offline copies of the documentation outside of
Xcode.

Jack

On Dec 18, 2016, at 10:46 PM, Jon Shier via swift-users < > swift-users@swift.org> wrote:

http://swiftdoc.org is a good online reference, though not always
completely up to date (just mostly).

Jon

On Dec 18, 2016, at 9:44 PM, Steven Harms via swift-users < > swift-users@swift.org> wrote:

Hi,

I've been playing with Swift in Linux contexts, but I was wondering, how
is one meant to consult reference work?

The Swift language book is written in iBooks...so I don't have access to
that in Linux. I'd love for there to be a PDF equivalent that I could leave
on the Linux environment to work with.

Alternatively, is there a rich HTML download of the API? I'm used to Perl
and Ruby which shipped rich HTML pages that allowed you to research the API
sans network connection.

I hate to think an IDE is required to use a language e.g. XCode. Surely we
should be able to code without an IDE's completion. I may be tempting the
nursing home by thinking vim and good docs should cut it :blush:.

Thanks,

Steven

_______________________________________________
swift-users mailing list
swift-users@swift.org
https://lists.swift.org/mailman/listinfo/swift-users

_______________________________________________
swift-users mailing list
swift-users@swift.org
https://lists.swift.org/mailman/listinfo/swift-users