This text is a work in progress—highly subject to change—and may not accurately describe any released version of the Apache™ Subversion® software. Bookmarking or otherwise referring others to this page is probably not such a smart idea. Please visit http://www.svnbook.com/ for stable versions of this book.

Trợ Giúp!
Prev  Chapter 2. Cách Sử Dụng Cơ Bản  Next

Trợ Giúp!

Không cần phải nói rằng cuốn sách này là nguồn thông tin và trợ giúp cho cả người sử dụng Subversion cũ và mới. Một cách tiện lợi, dòng lệnh Subversion tự bản thân nó là tài liệu, giảm bớt sự cần thiết của việc lấy một cuốn sách từ trên kệ (gỗ, ảo hay gì đó khác). Lệnh svn help là cửa ngỏ vào tài liệu được xây dựng bên trong đó:

$ svn help
usage: svn <subcommand> [options] [args]
Subversion command-line client, version 1.8.13.
Type 'svn help <subcommand>' for help on a specific subcommand.
Type 'svn --version' to see the program version and RA modules
  or 'svn --version --quiet' to see just the version number.

Most subcommands take file and/or directory arguments, recursing
on the directories.  If no arguments are supplied to such a
command, it recurses on the current directory (inclusive) by default.

Available subcommands:
   add
   blame (praise, annotate, ann)
   cat
…

Như được mô tả trong kết quả câu lệnh bên trên, bạn có thể yêu cầu giúp đỡ cho một lệnh phụ cụ thể bằng cách thực thi lệnh svn help SUBCOMMAND. Subversion sẽ phản hồi với thông tin sử dụng đầy đủ cho lệnh phụ đó, bao gồm cú pháp, tuỳ chọn và hành vi:

$ svn help help
help (?, h): Describe the usage of this program or its subcommands.
usage: help [SUBCOMMAND...]

Global options:
  --username ARG           : specify a username ARG
  --password ARG           : specify a password ARG
…

Tuỳ chọn, Khoá và Cờ

Ứng dụng khách Subversion giao-diện-dòng-lệnh có nhiều bổ lệnh. Một vài người đề cập tới như là “khoá” hoặc “cờ”—trong cuốn sách này, chúng tôi gọi là “tuỳ chọn”. Bạn sẽ tìm thấy những tuỳ chọn được hỗ trợ bởi từng lệnh phụ svn riêng lẻ, thêm vào đó là một tập những tuỳ chọn mà được hỗ trợ toàn cục bởi tất cả các lệnh phụ, được liệt kê gần bên dưới cùng của thông tin sử dụng đi kèm với lệnh phụ đó.

Tuỳ chọn Subversion có hai dạng tách biệt: tuỳ chọn ngắn là một dấu gạch ngang nối tiếp bởi một ký tự đơn, và tuỳ chọn dài bao gồm hai dấu gạch ngang nối tiếp bởi nhiều ký tự hoặc dấu gạch ngang (ví dụ, -s và --đây-là-tuỳ-chọn-dài, tương ứng). Mỗi tuỳ chọn có tối thiểu một định dạng tuỳ chọn dài. Một vài, như là tuỳ chọn --changelist, có bí danh viết tắt của tuỳ chọn dài (trong trường hợp này là --cl). Chỉ những tuỳ chọn cụ thể—thường là những cái được sử dụng nhiều nhất—có thêm định dạng tuỳ chọn ngắn. Để duy trì tính rõ ràng trong cuốn sách này, chúng tôi thường sử dụng dạng tuỳ chọn dài trong mã lệnh ví dụ, tuy nhiên khi mô tả những tuỳ chọn, nếu có tuỳ chọn ngắn, chúng tôi sẽ cung cấp dạng tuỳ chọn dài (để nâng cao tính rõ ràng) và dạng tuỳ chọn ngắn (để làm cho dễ nhớ). Sử dụng dạng mà bạn thấy phù hợp khi thực thi lệnh Subversion của riêng bạn.

Nhiều bản phân phối của Subversion dành cho các nền tảng dựa-trên-Unix tích hợp trang hướng dẫn sử dụng cuả những lệnh mà có thể được triệu gọi với chương trình man, nhưng những thành phần này có xu hướng chỉ trả về tham khảo tới những nguồn trợ giúp thực khác, ví dụ như website của dự án và tới website mà lưu trữ cuốn sách này. Ngoài ra cũng có rất nhiều công ty cung cấp hướng dẫn và hỗ trợ Subversion, thông thường là thông qua hình thức pha trộn giữa diễn đàn thảo luận dạng web và tư vấn có trả phí. Và dĩ nhiên, Internet lưu giữ giá trị của một thập kỷ các cuộc thảo luận liên quan đến Subversion có sẵn để được định vị bởi công cụ tìm kiếm của bạn. Trợ giúp Subversion luôn ở trong tầm tay của bạn.

Prev  Up  Next
Chapter 2. Cách Sử Dụng Cơ Bản  Home  Đưa Dữ Liệu Vào Trong Kho Lưu Trữ Của Bạn