Added building libraries

Author: ramonmeza

README.md

@@ -3,16 +3,26 @@
 My journey to understanding how Zig interacts with C and how I, someone not 
 well-versed in C, can leverage the power of third-party C libraries.
 
-This journey will include the following:
+## What This Doesn't Cover
 
+- Using Zig in C
+- Using C
+- C at all
+
+## TOC
+
+[The Journey](#the-journey)
 - [Create a Simple C application](#create-a-simple-c-application)
 - [Compiling the application using `zig cc`](#compiling-the-application-using-zig-cc)
 - [Leverage Zig's build system to build the C application](#leverage-zigs-build-system-to-build-the-c-application)
 - [Create a Zig application that links to the C library](#create-a-zig-application-that-links-to-the-c-library)
 - [Create a Zig wrapper around a C Function](#create-a-zig-wrapper-around-a-c-function)
-- [Create a Zig binding for the C library](#create-a-zig-binding-for-the-c-library)
+- [Using Zig to build a C Library](#using-zig-to-build-a-c-library)
+- [Linking a Zig application to a Pre-built C Library](#linking-a-zig-application-to-a-pre-built-c-library)
+
+[Side Quests](#side-quests)
+- [Testing C code in Zig](#testing-c-code-in-zig)
 
-- [Testing C code in Zig???](#)
 
 ## The Journey
 ### Create a Simple C Application
@@ -268,12 +278,13 @@ You can see, we use `@import("zmath.zig")` to import our wrapper functions. Then
 we use it just as you'd expect. Lastly, we have to update our `build.zig` file 
 to account for these changes.
 
-Our `build.zig` file is the same as last time. We still need to link the C code, 
-which is annoying and doesn't reflect how you might link C to Zig in "real-world" 
-situations, such as only has a library file. We'll cover linking C library files 
-in Zig, but first we'll build our library using Zig's build system.
+Our `build.zig` file is the same as last time. We link our source codes directly, 
+but what if the situation occurs where you have a library file you intend/to use 
+instead? Linking to a library file in Zig is simple, but first we need to create 
+our library files. I'll next cover creating static and shared libraries, using 
+our `zmath` C library.
 
-### Using Zig to build your C Library
+### Using Zig to build a C Library
 
 We'll use our `zmath` library we wrote in C and build it into a shared libary so 
 that we can dynamically link to rather than needing to include the source code 
@@ -284,10 +295,40 @@ Let's write out `build.zig` file:
 
 `build.zig`
 ```zig
-c
+const std = @import("std");
+
+pub fn build(b: *std.Build) *std.Build.Step.Compile {
+    const target = b.standardTargetOptions(.{});
+    const optimize = b.standardOptimizeOption(.{});
+
+    const lib = b.addStaticLibrary(.{
+        .name = "c_static_library_with_zig_build",
+        .target = target,
+        .optimize = optimize,
+    });
+
+    lib.addIncludePath(b.path("include"));
+    lib.addCSourceFiles(.{ .files = &[_][]const u8{"src/zmath.c"} });
+
+    lib.linkLibC();
+
+    b.installArtifact(lib);
+}
 ```
 
-###
+Again, very simple example. We add our source files, include directory, link it 
+to libc and install it. When we run `zig build`, our library will be compiled to 
+a static library file, `zig-out/lib/c_static_library_with_zig_build.lib`.
+
+If you want to compile shared libraries instead, there's not much difference. 
+Instead of `b.addStaticLibrary()`, use `b.addSharedLibrary()`.
+
+### Linking a Zig application to a Pre-built C Library 
+
+
+
+## Side Quests
+
+Some extra thoughts I have about integrating Zig and C together.
 
-## Bonus!
 ### Testing C code in Zig

build.zig

@@ -3,7 +3,8 @@ const std = @import("std");
 const module_ex1 = @import("build_c_application_with_zig_build.zig");
 const module_ex2 = @import("build_zig_linked_to_c.zig");
 const module_ex3 = @import("build_zig_c_wrapper.zig");
-const module_ex4 = @import("build_c_library_with_zig_build.zig");
+const module_ex4 = @import("build_c_static_library_with_zig_build.zig");
+const module_ex5 = @import("build_c_shared_library_with_zig_build.zig");
 
 pub fn build(b: *std.Build) void {
     const target = b.standardTargetOptions(.{});
@@ -38,10 +39,10 @@ pub fn build(b: *std.Build) void {
 
     // ex4
     const ex4 = module_ex4.build(b, target, optimize);
-    const run_ex4 = b.addRunArtifact(ex4);
+    const install_ex4 = b.addInstallArtifact(ex4, .{});
 
     b.installArtifact(ex4);
 
-    const run_ex4_step = b.step("ex4", "Create a shared library file from C source code.");
-    run_ex4_step.dependOn(&run_ex4.step);
+    const install_ex4_step = b.step("ex4", "Create a shared library file from C source code.");
+    install_ex4_step.dependOn(&install_ex4.step);
 }

build_c_library_with_zig_build.zig

@@ -0,0 +1,16 @@
+const std = @import("std");
+
+pub fn build(b: *std.Build, target: std.Build.ResolvedTarget, optimize: std.builtin.OptimizeMode) *std.Build.Step.Compile {
+    const lib = b.addSharedLibrary(.{
+        .name = "c_shared_library_with_zig_build",
+        .target = target,
+        .optimize = optimize,
+    });
+
+    lib.addIncludePath(b.path("include"));
+    lib.addCSourceFiles(.{ .files = &[_][]const u8{"src/zmath.c"} });
+
+    lib.linkLibC();
+
+    return lib;
+}

build_c_shared_library_with_zig_build.zig

@@ -0,0 +1,16 @@
+const std = @import("std");
+
+pub fn build(b: *std.Build, target: std.Build.ResolvedTarget, optimize: std.builtin.OptimizeMode) *std.Build.Step.Compile {
+    const lib = b.addStaticLibrary(.{
+        .name = "c_static_library_with_zig_build",
+        .target = target,
+        .optimize = optimize,
+    });
+
+    lib.addIncludePath(b.path("include"));
+    lib.addCSourceFiles(.{ .files = &[_][]const u8{"src/zmath.c"} });
+
+    lib.linkLibC();
+
+    return lib;
+}